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SUMMARY 

The  NASA  Charging  Analyzer  Program  (NASCAP)  is  a computer 
program  designed  to  model  the  electrostatic  charging  of  complicated 
three-dimensional  objects,  both  in  a test  tank  and  at  geosynchronous 
al ti tudes . 

This  document  is  a programmer's  reference  manual  and  user's 
guide.  It  is  designed  as  a reference  to  experienced  users  of  the 
code,  as  well  as  an  introduction  to  its  use  for  beginners. 

All  of  the  many  capabilities  of  NASCAP  are  covered  in  detail, 
together  with  examples  of  their  use.  These  include  the  definition  of 
objects,  plasma  environments,  potential  calculations,  particle  • 
emission  and  detection  simulations  and  charging  analysis. 


‘Prepared  for  NASA  Lewis  Research  Center  under  Contract  NAS3-22826. 
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1.  NASCAP  OVERVIEW 


1.1  WHAT  IS  NASCAP? 

NASCAP,  the  NASA  Charging  Analyzer  Program,  is  a computer 
program  designed  to  simulate  spacecraft  charging.  Spacecraft  charging 
is  the  build-up  of  electrostatic  potentials  on  the  surfaces  of 
spacecraft  exposed  to  a plasma  environment.  This  occurs  when  charged 
particles  from  the  plasma  collect  on  the  exposed  surface.  Both  the 
sign  and  the  magnitude  of  the  potential  acquired  from  exposure  to  the 
same  plasma  may  differ  for  different  surface  materials,  or  for 
different  areas  of  the  same  material  due  to  shadowing  or  electrostatic 
effects.  Thus  a complicated  object  composed  of  more  than  one  material 
may  charge  non-uniformly  leading  to  differential  charging,  i.e., 
potential  differences  between  different  parts  of  the  object. 
Differential  charging  can  cause  electrical  discharges  that  may  be 
damaging  to  satellite  systems. 

For  objects  as  structurally  complicated  as  man-made  satellites 
and  other  spacecraft,  predicting  their  interaction  with  a surrounding 
plasma  in  a test  tank  or  space  environment  becomes  a very  complex 
problem.  The  purpose  of  NASCAP  is  to  solve  this  problem  and  calculate 
such  observable  quantities  as  electric  potentials  and  currents  to  and 
from  the  spacecraft.  NASCAP  is  an  important  tool  for  the  analysis  of 
spacecraft  charging  and  the  interplay  between  the  various  mechanisms 
responsible. 

1.2  THE  PHYSICS  OF  SPACECRAFT  CHARGING 

The  atmosphere  around  the  earth  at  geosynchronous  altitude 
consists  of  a low  density,  energetic  plasma.  Both  electron  and  ion 
components  of  the  plasma  have  similar  Maxwell ian-1 ike  spectra,  so  that 
the  flux  of  the  much  lighter  electrons  greatly  exceeds  that  of  the 
ions.  If  the  collection  of  charge  were  due  only  to  primary  plasma 
currents,  all  materials  would  charge  to  negative  potentials  of  a few 
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times  the  plasma  temperature.  However,  the  Impact  of  both  primary 
electrons  and  ions  on  the  exposed  surface  causes  the  ejection  of  low 
energy  (<10  eV)  secondary  electrons  into  space.  Impacting  electrons 
can  also  be  reflected  as  backscatter.  These  mechanisms  all  act  as 
additional  sources  of  positive  current.  In  sunlight,  photoelectrons 
ejected  from  the  surface  also  act  as  a source  of  positive  current. 
Photoelectrons,  like  secondary  electrons,  have  low  energy.  Finally, 
current  may  flow  to  and  from  a surface  from  other  parts  of  the  object 
via  bulk  and/or  surface  conduction.  The  net  current  (i)  to  any 
surface  is  the  algebraic  sum  of  these  contributions: 


•electrons  . .ions  + .electrons  + .ions 
bet  primary  primary  Secondary  secondary 


.electrons  + . 
backscatter  conductivity 


+ 1 photoemission 


If  i . is  initially  negative,  the  exposed  surface  will  begin  to 
net 

acquire  a negative  potential.  As  the  magnitude  of  the  potential 
increases  the  net  current  is  attenuated,  until  it  eventually 
approaches  zero  and  the  surface  potential  remains  at  a steady 
equilibrium  value.  Equilibrium  potentials  of  up  to  -10  kV  have  been 
observed  in  geosynchronous  earth  orbit. 

If  i is  initially  positive,  the  exposed  surface  will  begin 
net  ... 

to  acquire  a positive  potential.  However,  large  positive  equilibrium 

potentials  are  not  normally  achieved.  This  is  because  low  energy 

secondary  and  photoemissions  provide  the  dominant  contribution  to  a 

positive  current.  As  soon  as  the  surface  reaches  a potential  greater 

than  the  energy  of  the  emitted  electrons  (5  or  10  eV)  they  can  no 

longer  escape  and  charging  stops.  In  this  case  equilibrium  is 

determined  by  the  suppression  of  low  energy  emission  due  to  the 

surface's  own  electric  field.  A similar  suppression  effect  may  occur 

due  to  the  electric  fields  of  neighboring  negatively  charged 

surfaces.  This  adds  to  the  complexity  of  the  situation  for  charging 
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of  complicated  objects  and  makes  spacecraft  charging  a truly 
three-dimensional  problem. 

1.3  NASCAP  CAPABILITIES 

NASCAP  is  a collection  of  the  various  models  and  algorithms 
needed  to  simulate  the  charging  of  a complex  object.  The  various 
formulations  are  written  to  levels  of  accuracy  and  approximation 
appropriate  to  solving  problems  for  geosynchronous-like  conditions  in 
a reasonable  amount  of  computer  time.  The  NASCAP  user  has  a great 
deal  of  flexibility  in  applying  these  capabilities  to  his  particular 
problem.  Among  NASCAP' s capabilities  are: 

• To  define  complex  objects  from  fairly  simple  input. 

• To  define  properties  of  materials  relevant  to  spacecraft 
charging. 

• To  calculate  electrostatic  potentials  around  complex  objects. 

• To  calculate  shadowing  of  one  part  of  an  object  by  another. 

• To  calculate  primary  currents  incident  on  spacecraft  surfaces 
from  a plasma  or  from  a point  source. 

• To  calculate  secondary  and  backscattered  electron  currents. 

• To  calculate  conductivity,  biasing,  and  grounding  currents. 

• To  calculate  charge  accumulation  and  resulting  surface 
potentials. 

e To  calculate  trajectories  of  charged  particles  incident  upon, 
or  emitted  from,  specified  surfaces. 

• To  meaningfully  communicate  results  through  printed  output, 
graphical  output,  and  interactive  post-processors. 

These  capabilities  satisfy  the  requirements  for  study  of  the  processes 
and  the  consequences  of  spacecraft  charging. 
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1.4  THE  NASCAP  PHYSICAL  MODEL 


NASCAP  objects  are  defined  within  a three-dimensional  cuboidal 
grid  (rather  like  a shoe  box).  The  grid  is  composed  of  many  thousands 
of  identical  cubes  or  volume  elements  stacked  together.  Objects  are 
defined  by  filling  or  partially  filling  the  cubes.  For  example,  a 
quasi-sphere  is  shown  in  Figure  1.1.  The  exterior  surfaces  of  the 
filled  volume  elements  form  the  exposed  surface  of  the  object.  Thus, 
the  object  surface  consists  of  rectangular  or  triangular  patches 
called  surface  cells.  In  addition  to  the  cubic  elements,  NASCAP 
allows  arbitrarily  narrow  cylindrical  booms  and  thin  plates  to  be 
defined.  The  definition  of  NASCAP  objects  is  discussed  in  detail  in 
Chapter  3. 


NASCAP  calculates  the  potentials  and  currents  for  an  object  that 
has  been  exposed  to  a plasma  environment  for  a chosen  period  of  time 
or  timestep.  The  initial  conditions  at  the  beginning  of  the  timestep 
may  be  specified  by  the  user  or  may  be  remembered  from  the  previous 
timestep  calculation.  Similarly  the  results  predicted  for  the  end  of 
the  current  timestep  may  be  used  as  the  initial  condition  for  the 
next,  and  so  on.  By  using  a sequence  of  timesteps,  a user  may  follow 
the  dynamics  of  the  approach  to  equilibrium  as  well  as  being  able  to 
examine  the  equilibrium  state  itself.  The  shorter  the  timesteps 
chosen,  the  more  will  be  needed  to  reach  equilibrium  and  the  greater 
the  detail  of  the  dynamic  charging  behavior  calculated. 


6 


For  each  timestep,  or  cycle,  NASCAP  calculates  the  total  amount 
of  charge  that  collects  on  each  surface  cell.  This  is  determined  from 
the  net  current  at  the  beginning  of  the  cycle,  taking  into  account  all 
of  the  contributions  mentioned  above.  The  variation  of  the  net 
incident  current  as  the  surface  potential  changes  during  the  cycle  can 
also  be  taken  into  account.  The  charge  collected  is  translated  into  a 
new  set  of  surface  potentials  via  a detailed  resistive-capacitive 
electrical  model  of  the  satellite.  Poisson's  equation  is  then  solved 
using  the  new  (fixed)  surface  potentials  to  give  new  updated 
potentials  in  the  space  surrounding  the  object.  The  new  potential  and 
electric  field  values  imply  a new  set  of  currents  in  the  next  cycle. 
Equilibrium  is  achieved  when  currents  and  potentials  reach  steady 
values  for  consecutive  timesteps.  The  details  of  the  many 
sophisticated  physical  models  that  are  part  of  NASCAP  are  discussed  in 
the  later  chapters.  However,  there  are  a number  of  assumptions  built 
in  that  define  the  physical  regime  where  NASCAP  works  best. 

1.5  THE  NASCAP  PHYSICAL  REGIME 

NASCAP  assumes  orbit-limited  spherical  probe  current 
collection.  This  is  a good  approximation  for  convex  objects  with 
radius  of  curvature  smaller  than  the  Debye  length  of  the  ambient 
plasma.  Hence  NASCAP  works  well  for  small  objects  (with  dimensions  of 
a few  meters  or  less)  in  geosynchronous  orbit  (where  Debye  lengths  are 
typically  hundreds  of  meters).  While  NASCAP  can  simulate  charging, 
taking  into  account  a space  charge  sheath  surrounding  the  object,  it 
is  primarily  designed  for  the  low  density,  high  temperature  plasmas 
found  at  geosynchronous  altitudes  where  space  charge  can  be  ignored. 
The  range  of  physical  regimes  where  NASCAP  can  be  most  profitably  used 
is  discussed  at  length  in  Reference  1. 

1.6  THE  NASCAP  FAMILY 

In  addition  to  the  large  NASCAP  code  described  in  this  manual, 
there  are  three  preprocessors  and  two  postprocessors  to  aid  in  the  use 
of  NASCAP  and  the  interpretation  of  NASCAP  results.  We  provide  very 
brief  descriptions  of  these  below. 
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1.6.1  MATCHG 


MATCHG  is  an  interactive  code  for  the  study  of 
material-environment  interactions  in  a zero-dimensional  sense.  It 
accepts  the  same  material  definition  as  NASCAP,  and  provides  the  same 
environment  types.  For  simple  cases,  use  of  MATCHG  can  obviate  the 
use  of  NASCAP,  while  for  complex  cases,  it  can  aid  the  user  to 
anticipate  and  understand  NASCAP  results. 

1.6.2  FILES 

FILES  is  a utility  to  aid  in  the  maintenance  (assign,  copy, 
delete)  of  NASCAP  restart  files. 

1.6.3  OBJCHECK 

OBJCHECK  is  a semi-interactive  version  of  the  object  definition 
portion  of  NASCAP. 

1.6.4  CONTOURS 

CONTOURS  is  an  interactive  contour  plotting  package.  Because  it 
makes  use  of  available  geometrical  information,  CONTOURS  provides 
plots  of  electrostatic  potential  superior  to  those  provided  directly 
by  NASCAP. 

1.6.5  TERMTALK 

TERMTALK  is  an  interactive  routine  which  extracts  information 
from  NASCAP  restart  files.  It  can  provide  flux  breakdown  for  a chosen 
surface;  time  history  of  potential,  flux,  or  field  for  chosen 
surfaces;  ordering  of  surfaces  by  potential,  flux,  or  field;  and 
definition  of  surface  cell  subsets. 
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2.  NASCAP  COMMAND  STRUCTURE 


2.1  EXECUTING  NASCAP  (OR  HOW  DO  I RUN  NASCAP?) 

NASCAP  is  delivered  as  one  executable  program  element,  or  in  the 
language  of  UNIVAC  and  CDC,  as  an  'absolute'.  To  run  NASCAP  one  needs 
only  to  "execute"  that  element.  For  example,  in  the  UNIVAC  world  if 
the  NASCAP  absolute  resides  as  element  'NASCAP*NASCAP.ABS'  then 
@XQT  NASCAP*NASCAP . ABS 

will  initiate  a NASCAP  run.  Such  a run  can  be  carried  out 
interactively,  or  in  batch  mode.  Running  NASCAP  interactively  can  be 
fun  for  very  simple  objects,  but  involves  many  minutes  (perhaps  hours) 
staring  at  an  inactive  screen  for  more  complex  examples.  Most  NASCAP 
runs  are  carried  out  in  batch  mode. 

Suppose  you  do  start  an  interactive  run  and  enter  the  line  above 
(or  its  equivalent).  What  happens  next?  Nothing!  NASCAP  is  waiting 
for  you  to  tell  it  what  to  do. 

2.2  KEYWORDS  (OR  HOW  DO  I TELL  NASCAP  WHAT  TO  DO?) 

NASCAP  has  a very  limited  vocabulary.  It  understands  only  a 
small  set  of  words.  These  are  called  keywords . 

The  keywords  tell  NASCAP  exactly  what  you  want  it  to  do.  There 
are  a number  of  very  basic  steps  the  program  must  do  to  provide  you, 
the  user,  with  potentials  and  currents.  These  include: 

1.  Understand  the  object  you  wish  to  analyze. 

2.  Calculate  its  capacitances. 

3.  Understand  the  plasma  environment  you  wish  to  study,  and 
then  go  ahead  and  calculate  the  potentials  on  the  object 
resulting  from  its  interaction  with  the  plasma. 

Not  all  of  these  basic  steps  need  be  repeated  with  each  execution  of 
the  program.  For  example,  you  may  wish  to  study  the  interaction  of 
the  same  sphere  with  different  plasma  environments.  It  is  more 
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efficient  to  do  this  without  defining  the  same  object  and  then 
recalculating  its  capacitances  each  time.  In  other  words,  it  would  be 
convenient  if  NASCAP  could  do  steps  1,  2 and  3 just  once  and  then 
repeat  step  3 with  different  environments.  To  enable  it  to  do  this, 
NASCAP  is  broken  up  internally  into  several  modules,  each  of  which  is 
activated,  or  executed,  by  its  primary  keyword. 

2.3  NASCAP  MODULES 

There  are  thirteen  NASCAP  modules.  Each  performs  a specific 
task,  may  require  additional  input  of  its  own,  and  may  require  output 
from  other  modules.  (This  is  explained  later  for  each  module.)  There 
is  only  one  module  that  must  be  executed  in  every  NASCAP  run  and  it 
must  always  be  executed  first.  This  is  the  mqdule  RDOPT , which  reads 
the  many  run  options  that  the  user  may  specify.  (More  about  RDOPT  and 
run  options  later  in  Chapter  6.) 

The  RDOPT  module  is  executed,  and  options  are  read,  by  entering 
the  keyword  'RDOPT'  as  NASCAP  input.  So  if  you  are  running  NASCAP 
interactively  and  you  type  RDOPT,  NASCAP  will  finally  do  something. 

It  will  read  the  options  from  file  26  (more  about  files  later  tool) 
and  echo  them  back  to  you.  Exactly  the  same  thing  happens  in  batch 
mode.  The  word  'RDOPT'  should  follow  the  statement  beginning  the 
execution  of  the  NASCAP  "absolute".  'RDOPT*  is  then  followed  by  other 
primary  keywords  describing  the  sequence  of  operations  appropriate  to 
your  problem.  The  primary  keywords  are  summarized  in  Table  2.1. 

The  actual  potential  and  current  calculations  are  carried  out  by 
module  TRILIN.  Before  TRILIN  can  be  successfully  executed  however,  it 
requires  knowledge  of  the  object  at  hand  and  its  capacitances.  This 
information  is  generated  by  the  execution  of  modules  OBJDEF  (OBJect 
DEFinition)  and  CAPACI  (CAPACItances)  respectively,  and  is  written  out 
by  them  to  their  output  files  (output  files  are  explained  in  Section 
2.6).  Unless  these  files  are  available  to  TRILIN  it  cannot  be 
executed  successfully. 


The  files  needed  by  TRILIN  can  be  generated  by  executing  OBJDEF 
and  CAPACI  in  the  same  NASCAP  run,  or  by  executing  them  in  a previous 
run  and  saving  their  output  files.  Whether  in  the  same  run  or  in 
separate  runs,  the  modules  RDOPT , OBJDEF  and  CAPACI  must  be  executed 
in  that  historical  order  for  each  new  object  defined  before  attempting 
to  execute  TRILIN.  Once  OBJDEF  and  CAPACI  have  been  executed,  and 
their  files  established,  subsequent  runs  can  skip  straight  from  RDOPT 

to  TRILIN. 

2.4  THE  NASCAP  RUNSTREAM 

The  sequence  of  primary  keywords  that  tell  NASCAP  what  modules 
to  execute  form  the  NASCAP  runstream.  The  simplest  runstream  consists 
of  just  two  keywords: 

RDOPT 

END 

RDOPT  must  always  be  the  first  keyword  encountered  in  any  run,  and  all 
runs  must  be  termi nated  wi th  the  card  END  . 


The  runstream  above  will  not  do  any  actual  calculations.  Module 
RDOPT  will  be  executed,  and  read  input  from  the  run  options  file 
(2.6).  NASCAP  will  then  print  out  the  resulting  option  values,  will 
assign  required  scratch  and  restart  files,  and  exit. 

A more  typical  runstream  has  the  form 
COMMENT  first  run 
RDOPT 
OBJDEF 
CAPACI 
TRILIN 
END 

These  four  modules  must  be  executed  in  this  order  to  obtain  currents 
and  potentials.  Note  that  the  word 
COMMENT 

is  also  a primary  keyword.  It  is  read  and  has  no  effect.  This  allows 
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parts  of  the  NASCAP  runstream  to  be  labeled  with  reminders.  The  same 
effect  could  be  achieved  with  two  separate  runs,  i.e.: 

COWENT  first  run 

RDOPT 

OBJDEF 

CAPACI 

END 

followed  by 

COMMENT  second  run 

RDOPT 

TRILIN 

END 

(Note  that  RDOPT  is  executed  in  both  runs.)  Further  potential 
calculations  can  be  made  with  more  runs  of  the  form 
RDOPT 
TRILIN 
END 

Once  OBJDEF  and  CAPACI  have  been  executed  once,  and  their  output  files 
saved,  TRILIN  can  be  executed  by  itself. 

The  remaining  modules  are  all  optional,  in  the  sense  that  they 
are  not  necessary  to  calculate  potentials.  They  too,  however,  must  be 
executed  according  to  their  order  of  precedence. 

2.5  ORDERS  OF  PRECEDENCE  (OR  WHAT  COMES  AFTER  RDOPT?) 

Table  2.2  sumnarizes  the  formal  rules  of  precedence.  The  second 
column  gives  the  module  that  must  precede  execution  of  the  module  at 
hand,  and  the  third  column  the  module  that  it  logically  precedes.  For 
example  HIDCEL,  which  calculates  the  shadowing  of  an  object  in 
sunlight  prior  to  the  calculation  of  its  photoemission,  must  be 
preceded  by  OBJDEF.  Otherwise  there  would  be  no  object  to  shadow. 
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It  logically  precedes  TRILIN,  since  TRILIN  uses  the  shadowing 
information  to  calculate  the  photocurrent.  If  we  were  going  to  use 
HIDCEL  in  a full  NASCAP  run,  it  would  come  between  OBJDEF  and  TRILIN. 


OBJDEF 


HIDCEL 


TRILIN 


However,  OBJDEF  must  be  preceded  by  RDOPT.  Furthermore  we  must 
execute  CAPACI  for  each  new  object.  CAPACI  and  HIDCEL  both  have  the 
same  order  of  precedence,  and  so  both  of  the  following  sequences  of 
cards  are  acceptable: 


RDOPT 

RDOPT 

OBJDEF 

OBJDEF 

HIDCEL 

CAPACI 

CAPACI 

HIDCEL 

TRILIN 

TRILIN 

END 

END 

Table  2.2  contains  enough  information  to  determine  unambiguously  an 
acceptable  sequence  of  primary  keywords  in  all  cases. 
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It  is  possible  to  make  multiple  calls  to  the  same  module  in  the 
same  runstream.  For  example,  when  using  ROTATE  this  is  required. 
COMMENT  rotate  run 
RDOPT 
OBJDEF 
CAPACI 
HIDCEL 
TRILIN 
ROTATE 
TRILIN 
ROTATE 
TRILIN 
END 

This  run  calls  TRILIN  three  times,  with  the  sun  at  different  angles  to 
the  object.  The  orientation  of  the  sun  is  calculated  by  ROTATE  to 
simulate  a spinning  satellite. 

2.6  FILES 

NASCAP  generates  large  amounts  of  information  in  the  form  of 
lists  and  arrays  as  each  of  the  modules  are  executed;  too  much 
information  to  be  held  in  program  memory.  To  overcome  this  problem 
NASCAP  stores  information  by  writing  it  out  to  a file,  and  reads  it 
back  into  memory  only  when  needed.  Writing  to  files  also  allows 
modules  to  share  information  with  each  other,  both  in  the  same  run  and 
separate  runs. 

The  UNIVAC  version  of  NASCAP  assigns  all  of  its  own  (temporary) 
output  (or  scratch)  files.  Versions  running  under  other  operating 
systems  require  the  user  to  pre-assign  these  files.  A list  of  output 
files  is  shown  in  Table  2.3.  There  are  a minimum  of  14.  Some  options 
require  additional  output  files.  (This  is  explained  in  sections 
dealing  with  those  options.) 
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Input  files  roust  be  assigned  (and  written)  by  the  user.  There 
are  three  principle  input  files:  The  object  definition  file,  the  flux 
definition  file  and  the  run  options  file. 

The  object  definition  file  contains  sets  of  secondary  keywords 
and  parameters  that  define  the  structure  of  the  object.  This  is  read 
by  module  OBJDEF  and  is  discussed  in  detail  in  Chapter  3. 

The  flux  definition  file  also  consists  of  secondary  keywords  and 
parameters.  It  defines  the  plasma  spectrum  and  its  angular 
distribution,  in  space  or  in  a test  tank.  This  is  read  by  module 
TRILIN  and  is  discussed  in  Chapter  5. 

The  run  option  file  is  read  by  RDOPT  and  lists  the  options 
chosen  by  the  user,  from  the  many  available  that  control  the  way  the 
program  runs.  Each  option  is  specified  with  a secondary  keyword. 

This  is  explained  in  Section  6.1. 

The  default  input  file  numbers  for  each  primary  keyword  are 
shown  in  Table  2.4.  The  input  file  numbers  can  be  specified  by  the 
user  simply  by  following  the  primary  keyword  by  the  file  or  unit 
number;  e.g., 

RDOPT  24 

will  cause  the  RDOPT  module  to  search  for  input  in  file  24  instead  of 
the  default  file  26. 

FILE  5 is  the  NASCAP  runstream;  i.e., 

RDOPT  5 

will  cause  the  cards  following  'RDOPT  5‘  in  the  NASCAP  runstream  to  be 
read  by  module  RDOPT.  In  the  same  way 
OBJDEF  5 

will  cause  module  OBJDEF  to  read  cards  from  the  keyword  runstream,  and 
so  on.  In  this  way  all  NASCAP  input  can  be  included  in  one 
self-contained  runstream.  For  example: 
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@XQT  NAS CAP* NASCAP. ABS  (UNIVAC) 
f RDOPT  5 

{ rdopt  options  (Chapter  6) 

( END 

f OBJDEF  5 

{object  definition  cards  (Chapter  3) 

(END 

CAPACI 

HIDCEL 
(TRILIN  5 

{plasma  environment  cards  (Chapter  5) 

(END 

END 

NASCAP  also  assigns  names  to  each  file  number.  For  example, 
file  22  read  by  TRILIN  is  called  IFLUX.  The  default  file  (number  22) 
can  be  changed  by  setting  IFLUX  to  a different  value.  IFLUX  and  the 
other  files  may  be  set  by  the  user  as  run  options.  (This  is  discussed 
in  Chapter  6 dealing  with  RDOPT  and  run  options  in  detail.)  Changing 
IFLUX  from  22  to,  say  <n>,  causes  the  default  TRILIN  file  to  be 
changed  from  22  to  <n>  for  that  particular  run  only.  So  multiple 
calls  to  TRILIN  will  read  from  file  <n>  each  time  if  no  file  number  is 
included  after  the  keyword;  e.g., 

TRILIN 

TRILIN 

will  read  from  the  new  default  <n>.  Including  a file  number  after  the 
keyword  has  the  same  effect  as  changing  IFLUX. 

The  names  of  each  file  are  included  in  Tables  2.3  and  2.4. 

Table  2.5  gives  a list  of  spare  file  numbers  available  to  the  user  up 
to  49.  The  following  discussion  assumes  the  user  will  use  the  default 
file  numbers  for  NASCAP  output  files. 
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2.7  RESTART  FILES 


If  NASCAP  information  is  intended  for  use  in  subsequent  runs 
some  of  the  output  files  must  be  made  permanent  and  saved.  Only  six 
need  to  be  saved.  These  are  called  the  restart  files.  They  are  files 

10,  15,  16,  17,  21,  27  (and  19  for  runs  specifying  TANK). 

These  files  store,  among  other  things,  the  object  definition  and 
capacitance  information  that  allow  TRILIN  to  be  executed  in  runs 
subsequent  to  OBJDEF  and  CAP AC I.  They  also  allow  information  from 
previous  TRILIN  cycles  (or  timesteps)  to  be  used  by  new  TRILIN 
executions,  and  to  continue  charging  sequences  from  where  previous 
runs  left  off.  This  is  carried  out  using  the  RESTART  option  discussed 
in  Section  6.2.9. 

It  is  also  often  useful  to  save  file  2.  This  allows  graphical 
output  to  be  replotted  later  (see  Chapter  9). 

2.8  TECHNICAL  DISCUSSION 

All  NASCAP  output  files  are  sequential  files  accessed  by  Fast 
I/O  routines,  except  file  21  (and  38).  File  21  is  a random  access 
file.  In  the  UNI VAC  version  of  NASCAP  the  routines  FASTRW,  FASREW, 
FASPOS  are  used  to  access  all  files.  In  CDC  versions,  BUFFER  IN  and 
BUFFER  OUT  (MSIO  for  file  21)  perform  this  function.  The  random 
access  file  21  contains  surface  cell  information  and  other  run 
parameters  in  individual  records.  The  record  "housekeeping"  is 
carried  out  by  routine  CELLIO.  Access  calls  always  occur  via  this 
routine.  The  information  stored  in  each  record  is  summarized  in 
Table  2.6. 
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2.9  SUMMARY 


NASCAP  is  divided  into  thirteen  MODULES,  each  of  which  is 
activated  by  its  primary  keyword.  NASCAP  runstreams  consist  of  a 
control  card  to  execute  the  program  "absolute",  followed  by  a sequence 
of  primary  keywords.  The  execution  of  the  NASCAP  modules  and  hence 
the  order  of  the  keywords  must  follow  certain  rules  of  precedence. 
NASCAP  reads  and  writes  Information  to  files.  If  six  of  these  files 
(the  restart  files)  are  made  permanent,  separate  runs  may  share 
information. 
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TABLE  2.1.  NASCAP  MODULES  AND  PRIMARY  KEYWORDS 


Module  and 

Addi ti onal 

Keyword 

Task 

Input 

CAPACI 

Calculates  object  capacitances 

No 

DETECT 

Enables  DETECTOR  run  option 

Yes.  Default  - 
assumes  input  follows 
keyword  (Unit  5) 

HIDCEL 

Calculates  the  shadowing  of  an 
object  illuminated  by  the  sun 

No 

IPS 

Sets  up  initial  potentials 
other  than  zero  on  surface 
cells 

Yes.  Default  - 
assumes  input  follows 
keyword  (Unit  5) 

NEWMAT 

Defines  new  material  properties 

Yes.  (No  default  - 
input  file  must  be 
specified) 

OBJDEF 

Reads  and  processes  object 
definition  information 

Yes.  Default  - read 
object  definition 
from  file  20 

RDOPT 

Reads  run  option  and  initializes 
program  parameters 

Yes.  Default  - read 
option  from  file  26 

ROTATE 

Causes  NASCAP  to  model  a 
rotating  object 

Yes.  (No  default  - 
input  file  must  be 
specified) 

SATPLT 

Produces  plots  and  pictures  of 
the  object 

No 

SPIN 

Causes  NASCAP  to  model  a 
rotating  object  by  averaging 
the  effect  of  the  sun  and 
magnetic  field  over  one 
rotation 

Yes.  (No  default  - 
input  file  must  be 
specified) 

STRESS 

Searches  for  insulating  cells 
having  the  highest  internal 
stress 

Yes.  (No  default  - 
input  file  must  be 
specified) 

TANK 

Defines  a test  tank  environ- 
ment with  multiple  particle  guns 

Yes.  Default  - 
read  gun  definitions 
from  file  22 

TRILIN 

Reads  parameters  describing  the 
plasma  environment  and  cal- 
culates potentials  and  currents 

Yes.  Default  - read 
environment  from 
file  22 
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TABLE  2.2.  PRECEDENCE  OF  PRIMARY  KEYWORDS 


Keyword 

Must  Be  Preceded  By 

Logically  Precedes 

CAPACI 

OBJDEF 

TRILIN  or  IPS 

DETECT 

TRILIN  (or  IPS) 

(None) 

HIDCEL 

OBJDEF 

TRILIN 

IPS 

CAPACI 

TRILIN  or  DETECT 

NEWMAT 

OBJDEF 

TRILIN 

OBJDEF 

RDOPT 

CAPACI 

RDOPT 

(None) 

(All) 

ROTATE 

TRILIN 

TRILIN 

SATPLT 

OBJDEF 

(None) 

SPIN 

OBJDEF 

TRILIN 

STRESS 

TRILIN 

(None) 

TANK 

RDOPT 

TRILIN* 

TRILIN 

CAPACI 

DETECT 

COMMENT 

(None) 

(None) 

* If  shadowing  options  HIDCEL,  SPIN  or  ROTATE  are  chosen,  they  must 
follow  TANK  before  TRILIN. 
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TABLE  2.3.  NAS CAP  OUTPUT  FILES 


Defaul t 
File  No. 


2 


10 

(RESTART) 


11 


12 
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File  Name  Written  By 

Read  By 

Information 

Content 

None  | 

OBJDEF 

SATPLT 

HIDCEL 

♦ROTATE  NAS  CAP*PLOTREAD . 

SPIN  (Chapter  9) 

DETECT 
TRILIN 

V 

NAS CAP  graphics 
call s. 

♦when  plot 
options  are 
specified 

| 

IP 

i 

(TRILIN  1 

CAPACI  < 

(IPS  1 

TRILIN 

CAPACI 

(IPS 

Conjugate  gradient 
scratch  file  (Sec- 
tion 3.15) . Con- 
tains potential 
array  on  completion 
of  TRILIN,  CAPACI  or 
IPS. 

IAUN 

1 

(TRILIN 
J CAPACI 
(IPS 

[TRILIN 
1 CAPACI 
1 IPS 

Conjugate  gradient 
scratch  file  (Sec- 
tion 3.15). 

SPIN 

SPIN 

SPIN  scratch 
file  - used  to 
store  shadowing 
information. 

IR 

(TRILIN  | 

{CAPACI  < 

(IPS  j 

(TRILIN 
CAPACI 
[ IPS 

Conjugate  gradient 
scratch  file  (Sec- 
tion 3.15). 

IU 

(TRILIN  | 

{CAPACI  < 

IPS  | 

(TRILIN 

CAPACI 

IPS 

Conjugate  gradient 
scratch  file  (Sec- 
tion 3.15) . 
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Default 
File  No. 


14 


15 

(RESTART) 


16 

(RESTART) 


17 

(RESTART) 


18 


19 

(RESTART 

when 

'TANK'  is 
specified) 


TABLE  2.3.  NASCAP  OUTPUT  FILES  (CONTINUED) 


Information 

File  Name  Written  By 

Read  By 

Content 

TRILIN 

(TRILIN 

Conjugate  gradient 

I SPARE 

CAPACI 

CAPACI 

scratch  file  (Sec- 

i 

(IPS 

(IPS 

tion  3.15). 

I 

" HIDCEL  i 

i SPIN 

TANK  < 

r HIDCEL 
[SPIN 
TANK 

Scratch  file 
for  shadowing 

1 SATPLT 

| SATPLT 

information. 

( 

. ROTATE  1 

, ROTATE 

1 

(TRILIN  | 

TRILIN 

Charge  density 

IROUS 

CAPACI  < 

CAPACI 

array. 

(IPS  | 

IPS 

Associated  inde- 

TERMTALK  infor- 

IPQCND 

TRILIN  pendent  program 

'TERMTALK* 

mation  (Section 

ILTBL 

OBJDEF  | 

r OBJDEF 
l CAPACI 
TRILIN 
1 IPS 
, DETECT 

Object  volume 
element  table 
(LTBL) . 

IOBJ 

None 

None 

Reserved  for 
future  use. 

IOBPLT 

TANK 

TRILIN 

Beam  shadowing 
information . 
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TABLE  2.3.  NASCAP  OUTPUT  FILES  (CONCLUDED) 


Default 
File  No. 

File  Name 

Written  By 

Read  By 

Information 

Content 

- 

21 

(RESTART) 

ICNOW 

All 

All 

Individual  cell 

information 

(Section 

- 

25 

IDIV 

(trilin 

{ CAPACI 
(IPS 

[TRILIN 

CAPACI 

[IPS 

D2  (Scaled 
conjugate  gra- 
dient array). 

27 

(RESTART) 

I AREA 

' 

OBJDEF 

1 

(trilin 

CAPACI 

(IPS 

Boom  conjugate 
gradient  ma- 
trices. 

* 

28 

I PART 

TRILIN 

DETECT 

Particle  plot- 
ting informa- 
tion. 

- 

38 

None 

DETECT 

(User 

program) 

Particle  trajec- 
tory information 
(Chapter  7) . 

46 

None 

END 

- 

EXEC  file  to 
automatical  1 y 
execute  PLOTREAD. 
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TABLE  2.4.  USER  INPUT  FILES 


NASCAP  Default  File 


Name 

Number 

Read  By 

Information  Content 

None 

5 

Main  Program 

NASCAP  KEYWORDS  and 
runstream  (cannot  be 
changed) . 

ISPECTR 

9 

TRILIN  in  'UPDATE'  or 
'DIRECT'  modes 
(Chapter  5) 

Environment  informa- 
tion (Chapter  5). 

I SAT 

20 

OBJDEF 

Object  definition 
statements  (Chapter  3). 

I FLUX 

22 

TRILIN  or  TANK 

Environment  informa- 
tion (Chapter  5). 

IKEYWD 

26 

RDOPT 

User  specified  options 
(Chapter  6) . 

None 

None 

TRILIN  - when  EMITTER 
option  is  enabled 

Emitter  information 
(Chapter  7). 

None 

None 

DETECT 

Detector  information 
(Chapter  7) . 

None 

None 

NEWMAT 

Material  properties 
(Chapter  4) . 

None 

None 

IPS 

Initial  potential  speci- 
fications (Chapter  8). 

None 

None 

ROTATE 

ROTATE  parameters 
(Chapter  8) . 

None 

None 

SPIN 

SPIN  parameters 
(Chapter  8) . 
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TABLE  2.5.  SPARE  FILES  AVAILABLE  TO  THE  USER 


★ 


★★ 


1 

30 

3 

31 

4* 

32 

8 

33 

23 

34 

24 

35 

29 

36 

37 

47 

39 

48 

40** 

49 

42 

43 

44 

45 

Files  6 and  7 are  reserved  for  printed  and  punched  (not 
used)  output,  respectively. 


File  41  is  used  by  the  'DISSPLA'  graphics  package  and  is 
best  avoided. 
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TABLE  2.6.  FILE  21  RECORDS 


Record  No. 

Record  ID 

Length 

Content 

1 

VINS 

1024 

Potentials  of  insulating 
surface  cells  (V) 

2 

VPTS 

1024 

Not  used 

3 

EINS 

1024 

Electric  field  external  to 
insulating  surface  cells 
(V  mesh-*) 

4 

ATOT 

1250 

Areas  of  surface  cells  (mesh)2 

5 

AREA 

1250 

Fraction  of  the  area  of  surface 
cells  sunlit 

6 

C-INF 

1024 

Capacitance  of  insulating  cells 
to  plasma  ground  or  tank  wall 
(code  units) 

7 

DPTLST 

500 

List  of  double  points  (see  3.13) 

8 

C-COND 

1024 

Capacitance  from  the  surface  of 
an  insulating  cell  to  its 
underlying  conductor  (code 
units) 

9 

FLUX 

1250 

Explicit  net  particle  flux  to 
each  surface  cell  (code  units) 

10 

DQEMIT 

1024 

Change  in  charge  due  to  low 
energy  emitted  electron  for 
each  insulating  cell  (code 
units) 

11 

DQ 

1024 

Change  in  charge  for  each 
insulating  cell  (code  units) 

12 

PTLIST 

1024 

List  of  all  points  that  are 
corners  of  insulating  surface 
cells 

13 

APT 

1024 

Areas  associated  with  above 
points  (PTLIST)  (mesh)2 
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TABLE  2.6.  FILE  21  RECORDS  (CONTINUED) 


Record  No. 

Record  ID 

Length 

Content 

14 

LINS 

1024 

List  of  insulating  surface  cell 
numbers 

15 

VBOOM 

100 

Potentials  of  the  boom  cells  (V) 

* 

16 

SIGMA 

1024 

(Not  used) 

17 

EBOOM 

100 

Electric  fields  external  to 
boom  surface  cells  (V  mesh-1) 

- 

18 

DFDV 

1024 

Flux  derivatives  for  insulating 
surface  cells 

19 

CSCOND 

15 

Capacitance  of  each  conductor 
to  plasma  ground  or  test  tank 
wall  (code  units) 

20 

CIJSMA 

15 

Stray  capacitances  of  conductor 
to  spacecraft  ground  (code 
units) 

21 

SCMAT 

9537 

Conductivity  matrix  (code  units) 

22 

SCLIST 

9537 

Sparseness  pattern  of 
conductivity  matrix  (who 
connects  to  whom) 

- 

23 

CPTLST 

1024 

List  of  surface  points  which 
are  not  corners  of  insulating 
cel  Is 

24 

BINF 

141 

BINF  common  block  - boom 
parameters 

25 

BSHAD 

100 

Shadowing  factors  for  boom  cells 
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TABLE  2.6.  FILE  21  RECORDS  (CONTINUED) 


Record  No. 

Record  ID 

Length 

Content 

26 

XFLUX 

200 

Explicit  net  flux  for  boom 
cells  (code  units) 

27 

PPEE 

500 

Potentials  for  bottom  point  of 
a double  point  (conjugate 
gradient) 

28 

PYOU 

500 

Vector  U (conjugate  gradient) 
for  bottom  points 

29 

PARR 

500 

Vector  R (conjugate  gradient) 
for  bottom  points 

30 

PAUN 

500 

Vector  AU  (conjugate  gradient), 
for  bottom  points 

31 

PDIV 

500 

Vector  D^  (scaled  conjugate 
gradient)  for  bottom  points 

32 

PROUS 

500 

Charge  densities  for  bottom 
points  (code  units) 

33 

VCELLS 

1250 

Potentials  of  surface  cells  (V) 

34 

ECELLS 

1250 

External  electric  fields  of 
surface  cells  V (mesh~l) 

35 

PZLIST 

500 

List  of  bottom  points  held  at 
fixed  potentials 

36 

ZLIST 

1024 

List  of  top  points  held  at 
fixed  potentials 

37 

RFLAGS 

1 

Type  of  shadowing  performed 

38 

SURF3 

1251 

Common  block  - number  of 
surface  cells  (1)  and  surface 
cell  list  (1250) 

39 

MATLS 

316 

Material  properties  (MATLS 
common  block)  (see  Chapter  4) 

40 

VTXL 

6200 

Vertex  surface  cell  list 

41 

BOOMS 

111 

Common  block  - boom  information 
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TABLE  2.6.  FILE  21  RECORDS  (CONTINUED) 


Record  No. 

Record  ID 

Length 

Content 

42 

SILHOU 

6289 

Non-hidden  line  object  plotting 
information 

43 

BLOCKS 

597 

Common  block  - volume  cell 
information 

44 

TIMHIS 

150 

Elapsed  time  for  each  cycle 
performed  so  far  (seconds) 

45 

QSUHIS 

150 

Total  charge  on  the  object  at 
each  cycle  (code  units) 

46 

RELSAV 

35 

Time  and  conductor  potentials 
and  charges  for  current  cycle 
(volts  and  code  units) 

47 

INTSAV 

35 

Cycle  number,  number  of 
conductors,  etc. 

48 

RDOTSV 

100 

Residuals  for  each  conjugate 
gradient  iteration 

- 

49 

CAP R DO 

100 

Residuals  from  each  conjugate 
gradient  iteration  called  from 
CAPACI 

50 

PCONSV 

2250 

Conductor  potential  for  each 
cycle  completed  (V) 

- 

51 

PHCMAT 

9537 

Conductivity  matrix  including 
photoconductivity  (code  units) 

52 

CNDCUR 

60 

Currents  to  each  conductor  (A) 

- 

53 

FIFLUX 

1350 

Average  flux  to  each  surface 
cell  during  the  previous 
timestep  (A  m~2) 

54 

SCOPT 

5 

Common  block  - screening  options 

- 

55 

GUNS 

181 

Common  block  - multi  gun 
definition  information 

56 

FIN 

1250 

Incident  electron  current  to 
surface  cells  (A  m“2) 
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TABLE  2.6. 

FILE  21 

RECORDS  (CONCLUDED) 

Record  No. 

Record  ID 

Length 

Content 

57 

FOU 

1250 

Secondary  electron  current  from 
surface  cells  (A  m-2) 

58 

FINP 

1250 

Incident  ion  current  to  surface 
cells  (A  nr2) 

59 

FOUP 

1250 

Secondary  electron  current  due 
to  ion  impact  from  surface 
cells  (A  nr2) 

60 

FELB 

1250 

Backscatter  from  surface  cells 
(A  nr2) 

61 

PCURR 

1250 

Photocurrent  from  surface  cells 
(A  nr2) 

62 

BFIN 

250 

Incident  electron  current  to 
boom  cells  (A  nr2) 

63 

BFOU 

250 

Secondary  electron  current  from 
boom  cells  (A  m-2) 

64 

BFIP 

250 

Incident  ion  current  to  boom 
cells  (A  m-2) 

65 

BFOP 

250 

Secondary  electron  current  due 
to  ion  impact  on  boom  cells 
(A  nr2) 

66 

BFEL 

250 

Backscatter  from  boom  cells 
(A  m-2) 

67 

BPCU 

250 

Photocurrent  from  boom  cells 
(A  m-2) 

68 

ANIP 

4 

Anisotropic  flux  parameters 

69 

TNKSZ 

5 

Grid  truncation  information 

70 

CLST 

1024 

Field-induced  bulk  conductivity 
of  insulating  cells  (code  units) 

71 

FINER 

61 

(Not  used  by  NASCAP) 

72 

MCOND 

286 

Common  block  - capacitance 
between  conductors  and  fixing 
information 
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3.  DEFINING  OBJECTS 


3.1  COMPUTATIONAL  SPACE 

NASCAP  calculates  the  electric  potential  in  the  space 
surrounding  an  object  as  well  as  the  potential  of  the  object  itself. 
Before  it  can  determine  these  potentials  NASCAP  must  first  recognize 
and  understand  both  the  object  defined  and  the  amount  of  surrounding 
space  to  be  included  in  the  calculations.  The  total  amount  of  space 
(including  that  filled  by  the  object)  included  in  the  potential 
calculation  is  called  the  computational  space.  The  edges  of  the  space 
form  the  outer  boundary. 

3.2  THE  GRID 

The  computational  space  used  by  NASCAP  is  a three-dimensional 
Cartesian  space.  Any  point  may  be  determined  by  specifying  its 
coordinates  according  to  three  mutually  perpendicular  axes  X,  Y and 
Z.  If  all  three  axes  have  the  same  scale  we  may  imagine  the  space  to 
be  subdivided  into  many  small  identical  cubic  volumes  (with  the  length 
of  cube's  side  equal  to  one  axis  unit).  These  cubic  volumes  are 
called  volume  elements.  This  is  shown  in  Figure  3.1.  The  corners  of 
the  volume  elements  are  points  in  the  coordinate  system  or  nodal  (or 
grid)  points.  Each  grid  point  is  described  by  its  X,  Y,  Z 
coordinates.  For  example,  the  grid  point  labeled  in  Figure  3.1  is  (5, 
6,  8).  The  grid  points  and  the  volume  elements  filling  the  space 
between  them  form  a computational  grid  (or  just  a grid). 

The  default  NASCAP  grid  has  dimensions  17  x 17  x 33.  This  means 
that  there  are  17  points  (and  hence  16  length  units)  in  the  X and  Y 
directions  and  33  points  (32  length  units)  in  the  Z direction  (a 
"shoe  box-like"  space).  The  number  of  points  in  the  Z direction  can 
also  be  specified  by  the  user  to  be  a number  less  than  33  (6.4.8). 

The  length  unit,  or  distance  along  the  axes  between  points,  is  called 
the  grid  spacing  or  'XMESH'.  XMESH  is  determined  by  the  user  as  a run 
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Grid  Point 
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Figure  3.1.  Three-dimensional  computational  grid. 


option  (6.4.15).  It  may  be  any  positive  value,  and  so  the 
computational  space  may  be  any  physical  size.  However,  as  the 
absolute  size  of  XMESH  is  increased  the  smallest  amount  of  volume  that 
can  be  recognized  by  NASCAP  (the  volume  of  a volume  element)  is  also 
increased.  This  means  that  any  interesting  and/or  important  physical 
phenomena  that  occur  on  length  scales  much  smaller  than  XMESH  become 
too  detailed  for  NASCAP  to  model  - or  resolve.  Increasing  XMESH 
decreases  the  resolution  of  the  NASCAP  calculations. 

To  overcome  this  problem  and  allow  NASCAP  to  include  large 
amounts  of  computational  space  without  sacrificing  resolution 
everywhere,  nested  grids  are  allowed.  Two  grids  are  said  to  be  nested 
when  one  exists  inside  the  other.  NASCAP  allows  up  to  five  nested 
grids.  Each  shares  a common  origin  at  the  center  of  the  innermost 
grid.  The  grid  spacing  is  successively  doubled  from  grid  to  grid. 

For  example,  consider  grid  2 to  extend  from  -8  to  +8  in  the  X and  Y 
directions  and  -16  to  +16  in  the  Z direction  in  its  own  (doubled) 
coordinates,  and  the  inner  grid  (grid  1)  to  extend  to  and  from  the 
same  values  in  grid  1 coordinates.  In  grid  2 coordinates  grid  1 
extends  from  -4  to  +4  in  X and  Y and  -8  to  +8  in  Z only,  while  in  grid 
1 coordinates  grid  2 extends  from  -16  to  +16  and  -32  to  +32.  The  same 
relationships  then  apply  to  grid  2 and  3,  3 and  4,  and  so  on.  A 
two-dimensional  illustration  of  nested  grids  is  shown  in  Figure  3.2. 

Nested  grids  allow  a small  XMESH  and  hence  high  resolution  for 
the  innermost  grid  while  allowing  NASCAP  to  incorporate  large  amounts 
of  space  (with  coarser  resolution)  far  from  the  origin.  This 
arrangement  is  particularly  well  suited  to  the  calculation  of 
potentials  of  satellite-sized  objects  exposed  to  the  long  (many 
meters)  Debye  length  plasmas  found  at  geosynchronous  altitudes. 
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3.3  OBJECTS 


All  NASCAP  objects  are  confined  to  the  space  inside  the 
innermost  17  x 17  x 33  grid.  Only  BOOMS  (see  Section  3.6)  are  allowed 
to  extend  into  outer  grids.  If  "empty  space"  and  "object"  both 
coexist  in  the  same  computational  space  what  makes  objects 
distinguishable?  The  answer  is  that  NASCAP  can  distinguish  between 
volume  elements  that  are  filled  (with  object)  and  those  that  are  empty 
(except  for  ambient  plasma  of  course).  Once  we  have  this  distinction 
it  is  easy  to  see  how  objects  can  be  constructed  by  filling  in 
collections  of  volume  elements.  For  example,  a simple  cuboid  may  be 
constructed  by  filling  in  2 x 3 x 4 = 24  elements  as  shown  in  Figure 
3.3. 


While  arrangements  of  completely  filled  and  completely  empty 
cubes  can  be  quite  versatile  in  representing  objects  of  many  different 
shapes,  more  sophisticated  representations  are  possible  if  we  allow 
cubes  to  be  partially  filled  (or  as  a pessimist  might  say,  partially 
empty).  Only  three  partially  filled  cubes  are  allowed.  These  are 
shown  in  Figure  3.4. 

While  it  is  easy  to  see  how  objects  might  be  constructed  by 
filling  or  partially  filling  individual  volume  elements,  a command 
structure  that  required  the  user  to  specify  every  element  comprising 
an  object  would  be  very  cumbersome  to  use. 
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Figure  3.4.  Four  shapes  of  volume  cells  considered  by  the  NASCAP 
code:  (a)  empty  cube;  (b)  wedge-shaped  cell  with  110 

surface;  (c)  tetrahedron  with  111  surface;  (d)  truncated 
cube  with  111  surface. 
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3.4  BUILDING  BLOCKS 


To  greatly  simplify  the  user  definition  of  objects  NASCAP 
pre-defines  commonly  used  shapes  built  up  from  individual  elements. 
These  shapes  are  called  NASCAP  BUILDING  BLOCKS.  There  are  six. 

Cuboid 

Octagon 

Quasi  sphere 

Tetrahedron 

Wedge 

FILlll 

These  are  shown  in  Figure  3.5.  These  basic  shapes  can  be  defined  to 
be  any  size  (within  the  inner  grid).  NASCAP  automatically  includes 
the  correct  number  of  individual  elements  for  the  size  of  building 
block  chosen  by  the  user. 

3.5  COMMANDS  (OR  HOW  DO  I ACTUALLY  DEFINE  AN  OBJECT?) 

The  NASCAP  module  OBJDEF  is  responsible  for  recognizing  and 
understanding  the  OBJect  DEFined  by  the  user.  Just  as  the  primary 
keyword  (Chapter  2),  'OBJDEF'  in  the  main  runstream  causes  OBJDEF  to 
be  executed,  so  secondary  keywords  are  used  to  give  instructions  to 
the  OBJDEF  module.  As  explained  in  Chapter  2,  OBJDEF  reads 
information  from  a file  whose  default  number  is  20.  This  is  called 
the  object  definition  file  and  consists  of  a collection  of  secondary 
keywords  and  associated  parameters. 

Each  building  block  has  its  own  keyword.  For  example,  the 
quasi-sphere  is  associated  with  the  word  QSPHERE,  and  the  cuboid 
(rectangular  parallelepiped)  with  the  word  RECTAN.  The  building 
blocks  and  their  keywords  are  summarized  in  Table  3.1. 

Once  OBJDEF  has  read  a building  block  keyword  from  the  object 
definition  file,  it  then  expects  to  find  several  more  lines  (or  cards) 
setting  the  block  parameters.  These  might  include  the  dimensions  of 
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Figure  3.5.  The  six  building  block  types  are  shown  here.  The  uppermost 
object  shows  a FI  LI 1 1 smoothing  a corner.  Below,  from  left 
to  right  are  quasi-sphere,  octagon  right  cylinder,  tetrahedron, 
wedge,  and  rectangular  parallelepiped. 
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TABLE  3.1.  NASCAP  BUILDING  BLOCKS  AND  THEIR  KEYWORDS 


Keyword 

BOOM 

FIL111 

OCTAGON 

PATCHR 

PATCHW 

PLATE 

QSPHERE 

RECTAN 

TETRAH 


Building  Block  Description 
Long  thin  BOOM 

Smooth  inside  of  a diagonal  corner 
Right  octagonal  cylinder 
Surface  of  a rectangle 
Diagonal  face  of  a wedge 
Arbitrarily  thin  plate  or  cuboid 
Quasi  sphere 

Cuboid  or  rectangular  parallelepiped 
Tetrahedron 

Wedge  derived  from  half  a cube 


WEDGE 


the  building  block,  its  orientation  and  the  materials  that  cover  its 
surface.  (Surface  materials  are  discussed  in  Chapter  4.)  Finally, 
OBJDEF  expects  to  find  a line  1 ENDOB J 1 telling  it  that  no  more 
information  referring  to  the  present  block  is  coming  and  to  expect  the 
next  building  block  keyword.  The  information  to  be  entered  in  the 
object  definition  file  for  each  building  block  is  summarized  in  Table 
3.2.  Note  that  numbers  and  words  may  be  separated  by  one  or  more 
spaces  on  the  same  line.  (Input  is  free-format. ) 

3.6  BOOMS,  PLATES  AND  PATCHES 

A careful  inspection  of  Table  3.1  will  show  that  there  are  some 
building  blocks  that  are  not  derived  from  cubic  volume  elements. 

These  are  the  BOOM,  PLATE,  PATCHR  and  PATCHW. 

BOOMs  are  long  cylindrical  projections  that  may  have  an 
arbitrary  radius.  They  may  only  lie  along  the  X,  Y,  or  Z directions. 
Unlike  any  of  the  other  building  blocks  they  may  extend  beyond  the 
innermost  grid. 

PLATEs  are  arbitrarily  thin  cuboids  (RECTANS).  They  are  assumed 
to  have  only  a top  and  a bottom,  the  sides  being  of  negligible 
height.  They  always  lie  in  one  of  the  axis  planes  (XY,  XZ,  YZ). 

PATCHR  and  PATCHW  are  the  surfaces  only  of  a cuboid  and  wedge, 
respectively.  They  are  used  to  change  the  surface  material  patterns 
of  existing  building  blocks  and  should  never  be  defined  in  spaces  not 
already  occupied  by  solid  objects.  (Objects  defined  to  occupy  the 
same  space  are  explained  in  Section  4.7.) 
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TABLE  3.2.  OBJECT  DEFINITION  - FILE  20 


OBJECT  DEFINITION— FILE  20 


All  integer  input — except  for  “radius”  and 
“materialname.”  See  NASCAP  Users  Manual  for 
information  on  material  parameters. 


OBJECT  DEFINITION 
SYNTAX 

RECTAN 

CORNER  x y z 

OELTAS  Ax  Ay  AZ 

(UP  TO  6 SURFACE  CAROS) 

ENDOBJ 


WEDGE 
CORNER  x y z 
FACE  materialname  normal 
(type  110) 

LENGTH  AX  Ay  A2 

(UP  TO  4 SURFACE  CARDS) 

ENDOBJ 


OBJECT  DEFINITION 
EXAMPLES 

RECTAN 

CORNER  3-28 
DELTAS  1 2 4 
SURFACE  +X  ALUMINUM 
SURFACE  -X  ALUMINUM 
SURFA.CE  + Y ALUMINUM 
SURFACE  -Y  ALUMINUM 
SURFACE  + 2 ALUMINUM 
SURFACE  -Z  ALUMINUM 
ENDOBJ 

WEDGE 

CORNER  -3  2 1 
FACE  SI02  - 1 - 1 0 
LENGTH  1 1 3 
SURFACE  +X  SI02 
SURFACE  + Y SI02 
SURFACE  + Z GOLD 
SURFACE  -Z  SI02 
ENDOBJ 


TETRAH 
CORNER  x y z 
FACE  materialname  normal 
(type  ill) 

LENGTH  Ax 

(UP  TO  3 SURFACE  CARDS) 
ENDOBJ 


OCTAGON 
AXIS  x y z x'  y'  z' 

WIDTH  w 
SIDES 

(UP  TO  3 SPECIAL  SURFACE 
CARDS  ■*  + ". 
or  "C") 

ENDOBJ 


TETRAH 

CORNER  -3-2  8 
FACE  KAPTON  11-1 
LENGTH  2 

SURFACE  -X  TEFLON 
SURFACE  -Y  KAPTON 
SURFACE  +Z  TEFLON 
ENDOBJ 

OCTAGON 

AXIS  3.  2. -6  3.  2. -9 

WIDTH  3 
SIDE  1 

SURFACE  + SILVER 
SURFACE  - SILVER 
SURFACE  C M AGNES 
ENDOBJ 


BOOM 

AXIS  x y z x'  y'  z' 

RADIUS  radius  (floating  point) 
SURFACE  materialname 
ENDOBJ 


BOOM 

AXIS  0.  6.  0 0.  12.  0 

RADIUS  .25 
SURFACE  ALUMINUM 
ENDOBJ 


QSPHERE 
CENTER  x y z 
DIAMETER  d 
SIDE  s 

MATERIAL  matenalname 
ENDOBJ 


QSPHERE 
CENTER  0.  0.  0 
DIAMETER  4 
SIDE  2 

MATERIAL  NPAINT 
ENDOBJ 


OBJECT  DEFINITION  OBJECT  DEFINITION 
SYNTAX  EXAMPLES 


FIL111 

CORNERLINE  xyzx'y'z' 
FACE  materialname  normal 
(type  111) 

ENDOBJ 

PLATE 

CORNER  x y z 
DELTAS  Ax  Ay  AZ 

TOP  ±(^)  materialname 

BOTTOM  ± (y  ) materialname 
ENDOBJ 

PATCH  R 

CORNER  x y z 

DELTAS  Ax  Ay  AZ 

(UP  TO  6 SURFACE  CAROS) 

ENDOBJ 

PATCHW 
CORNER  x y z 
FACE  matenalname  normal 
(type  110) 

LENGTH  Ax  Ay  AZ 

(UP  TO  4 SURFACE  CARDS) 

ENDOBJ 


FIL111 

CORNER  3.  2.6.  - 5.  4.  6 
FACE  SOLAR  -l.-l.-l 
ENDOBJ 


PLATE 

CORNER  -1  -1  -10 
DELTAS  2 2 0 
TOP  +Z  CPAINT 
BOTTOM  -Z  CPAINT 
ENDOBJ 


PATCH  R 

CORNER  3-2  8 
DELTAS  1 0 1 
SURFACE  -Y  SCREEN 
ENDOBJ 

PATCHW 

CORNER  -3  2 7 
FACE  AQUADG  -1-10 
LENGTH  1 1 1 
ENDOBJ 


NOTES:  'normal'  is  three  values, 
each  either  + 1.  0.  or  - i 

SURFACE  CARD  has  the  following  format: 
SURFACE  ± materialname 


SPECIAL  SURFACE  CARD  is: 


SURFACE 


(?) 


matenalname 


OTHER  OBJECT  DEFINITION  COMMANDS 


ENDSAT 
COMMENT 
OFFSET i ) k 
CONDUCTOR  n 

DELETE  i j k 
unrecognized  word 


Must  be  last  card  in  file. 

No  effect. 

Moves  coordinate  origin 

Sets  number  of  underlying  conductor 

0<_n  <_15). 

Deletes  surfaces,  leaving  empty  ceil. 
Assumed  to  be  name  of  new  surface 
material.  Next  card  scanned  for 
parameters. 
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3.7  F IL 111  AND  TRANSPARENT  ANTENNA  SURFACES 


3.7.1  FIL111 

F IL111  is  a special  shape  designed  to  fill  in  "steps"  whose 
corner  line  runs  at  45°  to  the  grid  lines  in  any  axis  plane  (i.e.,  XY, 
ZY,  XZ)  (Figure  3.6a).  There  are  two  kind  of  "steps"  that  can  occur 
between  NASCAP  building  blocks.  For  example,  a small  cuboid  on  top  of 
another  creates  four  "steps"  that  lie  along  grid  lines  (Figure  3.6b). 
These  may  be  "filled  in"  or  smoothed  by  defining  a WEDGE  to  lie  along 
the  corner  1 ine  of  the  step.  A second  type  of  step  is  possible 
however  when,  for  example,  a tetrahedron  or  octagon  is  defined  to  sit 
on  top  of  another  building  block.  These  steps  have  corner  lines  that 
run  at  45°  between  grid  lines.  This  is  shown  in  Figure  3.6c.  Such 
steps  can  be  smoothed  or  filled  in  by  a combination  of  tetrahedra  and 
truncated  cubes.  This  combination  is  supplied  as  the  building  block 
FIL111. 

3.7.2  TRANSPARENT  ANTENNA  SURFACES 

Antenna  surface  cells  may  be  square  (defined  by  the  PLATE 
subroutine),  rectangular  (defined  by  the  ASLANT  subroutine),  or 
equilateral  triangle  (defined  by  the  ATET  subroutine).  No  provision 
is  made  for  right  triangle  antenna  cells.  Antenna  surface  cells  are 
automatically  treated  as  two-sided  by  NASCAP;  only  one  side  of  the 
surface  should  be  defined.  Antenna  surfaces  should  not  be  used  to 
supersede  solid  surfaces,  although  solid  surfaces  may  supersede 
antenna  surfaces.  Mesh  surfaces  are  marked  by  bit  4 of  the  surface 
cell  word  (equivalent  to  adding  16  to  the  material  number).  HIDCEL 
draws  the  cell  outlines  of  antenna  cells,  except,  of  course,  where 
they  are  shadowed  by  solid  objects.  For  line-plot  devices  such 
drawings  can  be  a bit  messy;  plots  are  far  better  on  color-fill 
devices.  For  material  plots,  mesh  surfaces  are  treated  as 
non-transparent. 
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Figure  3.6a.  A FIL111  building  block  all  by  itself. 


Figure  3.6b.  "Steps"  along  grid  lines. 


Figure  3.6c,  "Steps"  along  45°  angle  lines. 


3.8  BUILDING  BLOCK  PARAMETERS  (OR  WHO'S  ON  NEXT?) 

The  very  center  of  the  17  x 17  x 33  inner  grid  is  assumed  to  be 
the  origin  of  the  coordinate  system  0,  0,  0.  Hence  the  grid  itself 
extends  from  -8  to  +8  in  the  X and  Y directions  and  from  -16  to  +16  in 
the  Z direction.  This  coordinate  system  is  used  to  specify  the 
position  and  size  of  the  building  blocks  in  the  parameter  "cards"  or 
lines  following  the  building  block  keyword.  Let  us  examine  the 
definition  of  each  building  block  in  detail  to  see  how  this  works. 


3.8.1  RECTAN 

The  following  cards  define  a cuboid  or  rectangular 
parallelepiped: 

RECTAN 

CORNER  x y z 
DELTAS  ax.  Ay,  az 
SURFACE  +X  GOLD 
SURFACE  -Y  KAPTON 

(Four  more  SURFACE  cards  for  -X,  +Y,  +Z,  -Z) 
ENDOBJ 


Notes: 

1.  RECTAN:  is  the  building  block  keyword. 

2.  CORNER  x y z:  defines  the  coordinate  of  the  lowest  indexed 

corner  of  the  cuboid  (the  one  so  that  if  you  added  up  x + y + z 
it  would  give  the  lowest  (least  positive)  number). 

3.  DELTAS  ax.  Ay,  az:  gives  the  length  of  sides  of  the  cuboid 

along  the  X,  Y and  Z axes.  (Note  that  the  edges  of  the  cuboid 
must  lie  in  the  direction  of  the  three  axes.) 

4.  SURFACE  +X  GOLD:  assigns  the  material  GOLD  (see  Chapter  4)  to 

the  surface  of  the  cuboid  whose  normal  points  in  the  +X 
direction.  There  are  up  to  six  surfaces  that  may  be  assigned 
materials  (+X,  -X,  +Y,  -Y,  +Z,  -Z).  All  surfaces  that  will 
eventually  become  a surface  of  the  finished  object  (rather  than 
become  a connection  to  another  building  block)  must  be  assigned 
a material.  (For  surfaces  that  are  shared  with  other  building 
blocks  the  material  assigned  is  ignored.) 
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As  an  example,  the  following  cards: 


RECTAN 

CORNER 

-4 

2 - 

DELTAS 

3 

2 

SURFACE 

+X 

GOLD 

SURFACE 

+Y 

GOLD 

SURFACE 

+Z 

GOLD 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

-Z 

GOLD 

ENDOBJ 

define  a gold  bar  extending  from  -4  to  -1  in  the  X direction,  2 to  4 
in  the  Y direction  and  -1  to  +4  in  the  Z direction  (Figure  3.7). 

3.8.2  PATCHR 


PATCHR  is  defined  in  exactly  the  same  way  as  RECTAN. 

PATCHR 

CORNER  x y z 

DELTAS  ax  Ay  az 

<SURFACE  card(s)  (usually  just  one)> 

(e.g.,  SURFACE  +X  GOLD 
( ENDOBJ 

PATCHR  should  only  be  defined  within  an  existing  object  (see  4.7). 
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Figure  3.7.  RECTAN. 
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3.8.3 


WEDGE 


The  following  cards  define  a right  angled  wedge: 
WEDGE 

CORNER  x y z 

FACE  KAPTON  110 

LENGTH  ax  Ay  az 

{ SURFACE  +X  TEFLON 

( <Up  to  four  SURFACE  cards> 

ENDOBJ 


Notes: 

1.  WEDGE:  is  the  building  block  keyword. 

2.  CORNER  x y z:  defines  the  lowest  indexed  vertex  of  the  right 
angled  corner  of  the  wedge  (see  note  2,  3.8.1). 

3.  FACE  KAPTON  110:  contains  two  pieces  of  information: 

a.  'KAPTON'  assigns  the  material  KAPTON  to  the  surface  of  the 
face  of  the  wedge.  (The  face  is  the  sloping  surface  of  the 
wedge. ) 

b.  '1  1 O'  defines  the  direction  of  the  normal  to  the  face  and 
hence  the  orientation  of  the  wedge  itself.  The  normal  may  point 
in  any  of  the  following  directions  only: 

+1,  0 

+1,  0,  +1 

0,  11,  11 

(For  those  of  you  not  familiar  with  the  '1  1 O'  notation  a 
'1  1 O'  normal  is  a vector  pointing  to  the  coordinates  X = 1, 

Y = 1 and  Z = 0 from  the  origin.) 

4.  LENGTH  ax.  Ay,  az:  gives  the  lengths  of  the  sides  of  the  wedge 

parallel  to  the  X,  Y and  Z axes.  To  maintain  symmetry  two  of 
these  must  be  equal  (i.e.,  the  two  right  triangle  sides). 
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5.  SURFACE  +X  TEFLON:  assigns  the  material  'TEFLON'  (Chapter  4) 

to  the  surface  whose  normal  points  in  the  positive  X direction. 
There  are  up  to  four  remaining  surfaces  that  may  be  assigned 
materials  (see  3.8.1,  note  4).  These  all  have  normals  pointing 
along  one  of  the  axis  directions.  Along  which  axis  direction 
they  point  depends  on  the  orientation  of  the  wedge  or  the  choice 
of  normal  for  the  face  (note  2).  The  possible  combinations  of 
face  directions  and  remaining  surface  directions  are  summarized 
in  Table  3.3.  Cards  defining  materials  for  non-existent  faces 
are  ignored. 

As  an  example,  the  following  cards: 


WEDGE 

CORNER 

0 0 

0 

FACE 

GOLD  1 

LENGTH 

2 2 

2 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

+Z 

GOLD 

SURFACE 

-Z 

GOLD 

ENDOBJ 

define  a wedge  covered  in  gold  with  the  origin  as  one  of  its  corners 
and  a face  whose  normal  points  between  the  X and  Y axes  in  the  XY 
plane.  This  is  shown  in  Figure  3.8. 


3.8.4  PATCHW 


PATCHW  is  defined  in  exactly  the  same  way  as  a wedge. 

PATCHW 

CORNER  x y z 
FACE  GOLD  1-10 
LENGTH  ax  Ay  az 

<Up  to  four  SURFACE  cards  (usually  just  one)> 

ENDOBJ 

Like  PATCHR  (3.8.2)  it  may  only  be  used  to  define  a wedge  inside 
another  building  block.  This  is  explained  further  in  Section  4.7. 
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TABLE  3.3.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  WEDGE  ORIENTATION 


Normal  of  WEDGE  Face  Normals  of  Four  Remaining  Surfaces 


1 1 0 

-1  1 0 
1 -1  0 
-1  -1  0 
1 0 1 

-1  0 1 
1 0 -1 
-1  0 -1 
0 1 1 
0 -1  1 
0 1-1 
0 -1  -1 


"X,  -Y,  Z,  -Z 
x,  -Y,  Z,  -Z 
-X,  Y,  Z,  -Z 
X,  Y,  Z,  -Z 
-X,  Y,  -Y,  -Z 
X,  Y,  -Y,  -Z 
-X,  Y,  -Y,  Z 
X,  Y,  -Y,  Z 
X,  -X,  -Y.  -Z 
X,  -X,  Y,  -Z 
X,  -X,  -Y,  Z 
X,  -X,  -Y,  -Z 
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3.8.5 


TETRAH 


The  following  cards  define  a tetrahedron: 

TETRAH 

CORNER  x y z 
FACE  ALUMINUM  11-1 
LENGTH  ax 
SURFACE  -X  TEFLON 
SURFACE  -Y  TEFLON 
SURFACE  +Z  TEFLON 
ENDOBJ 

Notes: 

1.  TETRAH  is  the  building  block  keyword. 

2.  CORNER  x y z:  defines  the  coordinates  of  the  right  angled 
corner  of  the  tetrahedron.  There  is  only  one  of  these.  (It 
corresponds  to  the  corner  of  the  partially  filled  cubic  volume 
element  that  is  actually  filled.) 

3.  FACE  1 1 -1:  assigns  the  material  ALUMINUM  to  the  unique 

face  of  the  tetrahedron  opposite  the  right  angled  corner. 

'1  1 -1'  gives  the  direction  of  this  face's  surface  normal  and 

hence  the  orientation  of  the  tetrahedron.  The  following 
directions  only  are  allowed: 

+1,  +1,  +1 

(This  notation  is  the  same  as  explained  in  3.8.3,  note  3.) 

4.  LENGTH  ax:  gives  the  length  of  the  sides  along  the  X,  Y and  Z 

axis  directions.  (These  must  all  be  equal  to  preserve  symmetry.) 

5.  SURFACE  -X  TEFLON:  assigns  the  material  teflon  to  the 

remaining  surface  with  surface  normal  pointing  along  the 
negative  X axis  direction.  Up  to  three  surfaces  remain  to  be 
assigned  materials  (see  3.8.1,  note  2).  The  surface  normals  of 
these  surfaces  depend  on  the  orientation  of  the  tetrahedron  and 
hence  the  normal  of  the  "face".  Table  3.4  summarizes  these 
relationships.  Definitions  of  non-existent  surfaces  are  ignored. 
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TABLE  3.4.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  TETRAHEDRON  ORIENTATIONS 

Normal  of  TETRAHedron  Face  Normals  of  Three  Remaining  Surfaces 


1 1 1 
•1  1 1 
1-11 
1 1 -1 
■1  -1  1 
■1  1 -1 
1 -1  -1 


-X,  -Y,  -Z 
X,  -Y,  -Z 
-X,  Y,  -Z 
-X,  -Y,  Z 
X,  Y,  -Z 
X,  -Y,  Z 
-X,  Y,  Z 


-1  -1  -1 


X,  Y,  Z 
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As  an  example,  the  following  cards: 


TETRAH 

CORNER 

0 0 0 

FACE  KAPTON  1 1 

LENGTH 

2 

SURFACE 

KAPTON  -X 

SURFACE 

KAPTON  -Y 

SURFACE 

KAPTON  -Z 

ENDOBJ 

define  a tetrahedron  with  its  right  angle  corner  at  the  origin  and  the 
normal  of  the  opposite  face  pointing  between  the  positive  X,  Y and  Z 
axes.  This  is  shown  in  Figure  3.9. 

3.8.6  OCTAGON 


The  following  cards  define  a right  octagonal  cylinder: 

OCTAGON 

AXIS  x y 2 x'  y’  z' 

WIDTH  w 
SIDE  s 

SURFACE  + GOLD 
SURFACE  - GOLD 
SURFACE  C GOLD 
ENDOBJ 

Notes: 

1.  OCTAGON:  is  the  building  block  keyword. 

2.  AXIS  x y z x*  y‘  z':  defines  both  the  direction  of  the 
symmetry  axis  and  the  height  of  the  cylinder.  The  symmetry  axis 
must  be  parallel  to  one  of  the  axis  directions.  Thus  two  of  the 
coordinate  pairs  (x,  x'),  (y,  y * ) and  (z,  z * ) must  be 
identical.  For  example. 
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'AXIS  6 3 -2  7 4 -2' 


would  define  an  axis  that  was  not  parallel  to  the  X,  Y or  Z 
directions.  However, 

'AXIS  6 3 -2  7 3 -2' 

defines  an  axis  parallel  to  the  X direction  and  is  acceptable. 

The  height  of  the  cylinder  is  given  by  the  difference  in 
coordinates  along  the  axis  direction.  (For  example,  in  the  case 
above,  the  axis  is  one  mesh  unit  long.) 

3.  WIDTH  w:  gives  the  width  of  the  octagonal  cross-section  of  the 

cylinder  as  w.  If  WIDTH  is  chosen  to  be  odd,  the  axis  must  be 
moved  or  the  sides  of  the  cylinder  will  lie  halfway  across  a 
volume  element.  NASCAP  automatically  moves  the  axis  +1/2  a mesh 
unit  in  each  direction  in  the  plane  perpendicular  to  it. 

4.  SIDE  s:  gives  the  length  of  one  of  the  sides  of  the  octagonal 

cross-section  that  lies  in  an  axis  direction.  The  symmetry 
relationship  between  the  width  and  the  sides  of  the 
cross-section  is  shown  in  Figure  3.10.  To  maintain  this 
relationship  the  side  must  always  be  an  even  number  of  mesh 
units  less  than  the  width.  This  means  that  they  both  either 
must  be  odd  or  both  even  numbers  of  mesh  units. 

5.  SURFACE  + GOLD:  assigns  the  material  GOLD  to  the  top  surface  of 

the  cylinder.  and  'C'  replacing  the  '+'  assign  surface 
materials  to  the  bottom  or  side  cylindrical  surface, 
respectively.  Only  those  surfaces  that  will  eventually  become 
surfaces  of  the  completed  object  need  be  assigned  a material. 

As  an  example,  the  following  cards: 

OCTAGON 

AXIS  2 -4  6 2 -4  10 

WIDTH  5 
SIDE  3 

SURFACE  + TEFLON 
SURFACE  - TEFLON 
SURFACE  C TEFLON 
ENDOBJ 

defines  a right  octagonal  cylinder  covered  in  teflon.  The  symmetry 
axis  lies  along  the  Z direction  and  the  height  of  the  cylinder  is  four 
mesh  units.  Because  the  WIDTH  is  odd  the  axis  is  imagined  to  pass 
through  the  point  2 1/2,  -3  1/2  in  the  X Y plane.  Hence  the  top  and 
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bottom  faces  run  from  X = 0 to  X = 5 and  from  Y = -6  to  Y = -1.  The 
coordinates  of  the  top  of  the  cylinder  are  shown  In  Figure  3.10.  A 
three-dimensional  view  Is  shown  in  Figure  3.11. 


3.8.7  QSPHERE 

The  following  cards  define  a quasi sphere: 
QSPHERE 

CENTER  x y z 
DIAMETER  d 
SIDE  s 

MATERIAL  Si 02 
ENDOBJ 

Notes: 


1.  QSPHERE:  is  the  building  block  keyword. 

2.  CENTER  x y z:  defines  the  center  of  the  sphere  to  be  at 

coordinates  X,  Y,  Z. 

3.  DIAMETER  d:  defines  the  diameter  of  the  sphere  to  be  d mesh 

units.  The  quasi  sphere  can  be  thought  of  as  an  octagonal 
cross-section  (like  the  top  of  an  OCTAGON  (see  3.8.6) ) rotated 
about  an  axis  in  the  cross-section  plane.  The  diameter  then 
corresponds  to  the  WIDTH  for  a two-dimensional  octagonal 
section.  The  same  restrictions  then  apply:  An  odd  value  for 
the  DIAMETER  causes  NASCAP  to  automatically  move  the  CENTER  by 
+1/2  a mesh  unit  in  the  X,  Y and  Z directions. 

4.  SIDE  s:  sets  the  length  of  a side  lying  in  one  of  the  axis 

planes  (e.g.,  X Y plane).  Like  the  OCTAGON,  the  SIDE  and 
DIAMETER  must  differ  by  an  even  number  of  mesh  units. 

5.  MATERIAL  SI02:  assigns  the  material  SI02  to  the  whole  sphere 

surface . 

As  an  example,  the  following  cards: 

QSPHERE 

CENTER  1 -3  5 

DIAMETER  7 
SIDE  3 

MATERIAL  SILVER 
ENDOBJ 
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The 


define  a silver  sphere  centered  at  1 1/2,  -2  1/2  and  5 1/2. 
sphere  extends  along  the  axis  direction  as  follows: 
x from  -2  to  5 
y from  -6  to  1 
z from  2 to  9 

(See  Figure  3.12.) 

3.8.8  FIL111 

The  following  cards  define  a FIL111: 

FIL111 

CORNERLINE  x y z x'  y'  z' 

FACE  KAPTON  1 -1  -1 

ENDOBJ 


Notes : 


1.  FIL111:  is  the  building  block  keyword. 

2.  CORNERLINE  x y z x'  y'  z':  defines  both  the  length  and  the 

direction  of  the  “step"  FIL111  is  to  fill.  The  line  must  lie  in 
one  of  the  axis  planes  (XY,  XZ,  YZ)  and  must  have  a direction 
lying  45°  to  two  of  the  axes.  This  means  that  one  pair  of  the 
coordinates  (x',  x),  (y,  y')  (z,  z')  must  be  identical  and  the 
other  two  pairs  must  differ  by  the  same  magnitude.  For  example, 

'CORNERLINE  123  456' 

is  unacceptable  since  all  three  coordinate  pairs  change.  The 
following  correct  example 

'CORNERLINE  123  -143' 

defines  a line  in  the  XY  plane  (Z  is  constant)  with  ax  = -2,  and 
Ay  = +2.  Hence  the  line  is  Zr/Z  units  in  length  and  runs  at  45° 
between  the  positive  Y axis  and  the  negative  X axis. 

3.  FACE  KAPTON  1 -1  -1:  assigns  the  material  KAPTON  to  the 

exposed  surfaces  of  the  FIL111  and  defines  its  orientation  via 
the  surface  normal  of  its  exposed  face:  1 -1  -1.  The  surface 

normal  can  only  be  combinations  of 

+1  +1  +1 
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Figure  3.12.  QSPHERE. 
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Only  qertain  choices  of  corner  line  direction  are  consistent 
with  each  choice  of  FACE  normal.  If  we  subtract  the  xy  z, 
x'  y'  z1  coordinates  defined  in  corner  line 

ax  = x 1 - x 

&y  = y'  - y 
AZ  = Z ' - Z 

then  the  surface  normal  n^  n2  03  (e.g.,  Ill)  must  be 
orthogonal  to  ax.  Ay,  a z,  i.e., 

ax  • n\  + Ay  • n2  + az  • n3  = 0. 

With  the  choice  123  -1  4 3 for  the  corner  line 

coordinates  only  1 1 +1  or  -1  -1  +1  faces  are  permissible, 
e.g.. 


-2.  -1  + 2.  -1  + 0.  +1  = 0. 

However,  with  -1  +1  _+l 

-2.  -1  + 2.1  + 0.  +1  = 4 

the  vectors  are  not  orthogonal  and  so  are  not  allowed. 

As  an  example,  the  following  cards: 

FIL111 

CORNERLINE  14-6  17-3 

FACE  GOLD  -1  1 -1 

EN00BJ 

defines  a FIL 111  covered  with  gold  smoothing  a step  with  a corner  line 
running  from  1 4 -6  in  the  YZ  plane,  between  the  positive  Y and  Z 

axis  to  1 7 -3.  The  face  of  the  FIL111  points  in  the  negative  X and 

Z directions  and  positive  Y direction.  (See  Figure  3.13.) 
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Figure  3.13.  FIL111. 
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3.8.9 


PLATE 


The  following  cards  define  a PLATE: 
PLATE 

CORNER  x y z 
DELTAS  ax  Ay  az 

ALUMIN 


KAPTON 

ENDOBJ 


Notes: 


1.  PLATE:  is  the  building  block  keyword. 

2.  CORNER  x y z:  defines  the  vertex  of  the  thin  plate  with  the 
lowest  indices  (see  3.8.1,  note  2). 

3.  DELTAS  ax  Ay  az:  defines  the  length  of  the  plate  along  the 

three  axis  directions.  A PLATE  may  be  thought  of  as  a cuboid 
(or  RECTAN)  (see  3.8.1)  with  zero  thickness  in  one  direction. 
Hence  one  of  ax.  Ay  and  az  must  be  zero.  For  example,  if  Ay  is 
chosen  to  be  zero  the  PLATE  will  lie  in  the  xz  plane. 

4*  /X  \ 

TOP  + ( Y ) ALUMIN: 

assigns  the  material  ALUMIN  to  the  TOP  surface  of  the  plate. 

The  "TOP"  surface  may  be  either  in  a + or  - axis  direction. 

This  choice  is  arbitrary  unless  a "double  point"  conflict  is 
possible.  Double  point  conflicts  are  explained  in  Section  3.10. 

s.  /x\ 

BOTTOM  + ( Y 1 KAPTON : 

assigns  the  material  KAPTON  to  the  other  side  of  the  plate.  If 
"top"  were  chosen  as  +X  then  bottom  must  be  -X,  and  so  on.  Note 
that  the  choice  of  x,  y or  z must  coincide  with  the  ax.  Ay  or  az 
chosen  to  be  zero. 
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As  an  example,  the  cards 
PLATE 

. CORNER  000 
DELTAS  022 
TOP  -X  TEFLON 
BOTTOM  +X  GOLD 
ENDOBJ 

defines  a 2 x 2 thin  plate  with  gold  on  the  +X  side  and  teflon  on  the 
-X  side  lying  in  the  YZ  plane.  (See  Figure  3.14.) 

3.8.10  BOOM 


The  following  cards  define  a thin  BOOM: 
BOOM 

AXIS  x y z x’  y'  z' 

RADIUS  0.25 
SURFACE  SI02 
ENDOBJ 


Notes : 


1.  BOOM:  is  the  building  block  keyword. 

AXIS  x y z x'  y'  z':  defines  the  length  and  orientation  of 

the  boom,  x y z and  x'  y'  z'  are  the  coordinates  of  the 
beginning  and  end.  They  must  be  chosen  so  that  the  boom 
direction  coincides  with  one  of  the  axes. 

BOOMS  are  the  only  building  blocks  that  can  extend  into 
outer  grids.  This  may  be  done  in  two  ways. 

a.  The  AXIS  coordinates  may  be  specified  in  inner  grid  units. 
For  example 

'AXIS  0 0 0 0 0 20' 

defines  a BOOM  that  ends  at  the  +10  grid  point  of  the  second 
grid  in  the  Z direction.  (Recall  that  the  second  grid  has  twice 
the  inner  grid  spacing.)  Care  must  be  taken,  however,  not  to 
define  the  end  of  the  boom  between  outer  grid  points.  For 
example 

'AXIS  0 0 0 0 0 21* 
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defines  a boom  that  ends  halfway  between  two  second  grid  points 
and  is  illegal. 

b.  A second  method  avoids  this  problem.  The  same  boom  may  be 
defined  using  two  additional  parameters  or  "grid  numbers". 

'AXIS  0 0 0 1 0 0 10  2' 

This  has  the  format 

'AXIS  x y z ng  x'  y'  z'  ng' 

where  ng  is  the  starting  grid  number  and  ng'  is  the  ending  grid( 
number,  x y z are  now  in  ng  coordinates  and  x'  y'  z'  are  in  ng' 
coordinates.  Booms  are  not  allowed  to  pass  from  outer  grids  to 
inner  grids. 

3.  RADIUS  0.25:  defines  the  radius  of  the  thin  cylindrical  boom  to 

be  0.25  mesh  units.  The  radius  may  be  any  floating  point  number. 

4.  SURFACE  SI02:  assigns  the  material  SI02  to  the  BOOM  surface. 

As  an  example,  the  following  cards 
BOOM 

AXIS  -6  0 2 -6  0 32 

RADIUS  0.1 
SURFACE  KAPTON 
ENDOBJ 

define  a boom  along  the  X axis  with  radius  0.1  inner  mesh  units, 
covered  with  kapton.  It  runs  from  X = -6  in  the  inner  mesh  to  X = -10 
in  the  third  mesh.  (See  Figure  3.15). 
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3.8.11 


SQUARE  ANTENNA  MESH 


Square  (type  [100])  mesh  surfaces  are  defined  using  the  PLATE 
module  by  replacing  the  TOP/BOTTOM  specification  by  an  ANTENNA  card: 

Example 

PLATE 

CORNER  -4  -5  -6 
DELTAS  035 
ANTENNA  GOLD 
ENDOBJ 

Note  that  one  of  (dj,  d2,  dg)  must  be  zero,  and  the  surface 
normal  direction  is  not  specified. 

3.8.12  RECTANGULAR  ANTENNA  MESH 

Rectangular  (type  [110])  mesh  surfaces  are  defined  using  the 
ASLANT  subroutine,  which  is  syntactically  similar  to  the  WEDGE 
subroutine.  It  must  be  particularly  noted  that  the  CORNER  is  not 
located  on  (or  even  near)  the  mesh  surface,  but  is  the  corner  of  the 
WEDGE  of  which  the  antenna  surface  would  be  the  slanted  face: 

Example 

ASLANT 

CORNER  5 -3  -3 

FACE  KAPTON  -101 
LENGTH  464 

ENDOBJ 

Note  that  the  two  d^s  corresponding  to  nonzero  n^s  must  be 
equal.  ASLANT  will  not  accept  additional  surface  cards. 


Syntax 

ASLANT 

CORNER  x1  x2  x3 
FACE  matl  n^  n2  n^ 
LENGTH  dx  d2  d3 
ENDOBJ 


Syntax 

PLATE 

CORNER  xl  x2  x3 
DELTAS  dx  d2  d3 
ANTENNA  matl 
ENDOBJ 
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3.8.13 


TRIANGULAR  ANTENNA  MESH 


Equilateral  triangle  (type  [111])  mesh  surfaces  are  defined 
using  the  ATET  subroutine,  which  is  syntactically  similar  to  the 
TETRAH  subroutine.  It  must  be  particularly  noted  that  the  CORNER  is 
not  located  on  (or  even  near)  the  mesh  surface,  but  is  the  corner  of 
the  TETRAH  of  which  the  antenna  surface  would  be  the  slanted  face: 


Syntax 

Example 

ATET 

ATET 

CORNER 

X1  X2  X3 

CORNER  5 

-3  5 

FACE 

matl  n^  n^  n^ 

FACE  AQUADG  -1 

1 -1 

LENGTH 

d 

LENGTH  3 

ENDOBJ 

ENDOBJ 

ATET  will  not  accept  any  additiinal  surface  cards. 

3.8.14  EXAMPLES  OF  TRANSPARENT  ANTENNA  BLOCKS 

Figures  3.16a-h  show  MATPLT  and  HIOCEL  views  of  the  examples 
given  in  subsections  3.8.11,  3.8.12,  and  3.8.13. 
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Figure  3.16.  (Continued) 
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(H) 

Figure  3.16.  (Concluded) 


3.9  MORE  OBJECT  DEFINITION  KEYWORDS 


In  addition  to  the  building  block  keywords  and  the  parameter 
cards  that  follow  OBJDEF  also  recognizes  a few  other  keywords.  With 
these  and  the  building  blocks  a complete  object  definition  file  can 
finally  be  constructed.  This  is  discussed  in  Section  3.9.  Let  us 
examine  the  remaining  keywords  and  their  effect  one  by  one.  All  of 
the  OBJDEF  keywords  are  summarized  in  Table  3.1. 

3.9.1  ENDSAT 

Just  as  ENDOBJ  terminates  a set  of  building  block  parameter 
cards,  so  the  keyword  'ENDSAT'  terminates  the  whole  object  definition 
file.  After  reading  an  'ENDSAT'  card  OBJDEF  stops  trying  to  read  any 
more  keywords  from  the  object  definition  file  and  begins  to  process 
the  information  it  has.  Note  that  ALL  object  definition  files  must 
end  with  an  'ENDSAT'  card. 

3.9.2  COMMENT 

OBJDEF  ignores  anything  written  on  the  same  80  character  line 
(or  card)  that  begins  with  the  keyword  'COMMENT'.  This  allows  the 
user  to  include  notes  or  reminders  in  long  and  complicated  object 
definition  files,  e.g.. 


COMMENT  DEFINE  AXIAL  BOOM 
BOOM 

AXIS  -6  0 2 -8  0 2 
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3.9.3 


OFFSET 


The  card 

OFFSET  x y z 

relabels  the  grid  center  to  be  9-x,  9-y,  17-z  for  a standard 
17  x 17  x 35  inner  grid.  This  result  may  seem  rather  startling  until 
you  realize  that  the  so-called  "absolute"  NASCAP  coordinate  system 
labels  the  axes  from  1 to  17  in  the  X and  Y direction  and  1 to  33  in 
the  Z direction.  In  this  "absolute  system"  the  center  of  the  grid, 
which  we  had  previously  labeled  (0,  0,  0,)  becomes  (9,  9,  17).  So  we 
may  move  from  the  more  intuitive  0,  0,  0 centered  system  to  the 
"absolute"  system  with  the  command 
OFFSET  000 

To  illustrate  the  difference  the  following  two  sets  of  cards  define  a 
sphere  centered  at  the  center  of  the  grid. 


Default  coordinate  system 

Absol ute 

QSPHERE 

OFFSET 

CENTER  0 

0 0 

QSPHERE 

DIAMETER 

7 

CENTER  9 

SIDE  3 

DIAMETER 

MATERIAL 

KAPTON 

SIDE  3 

ENDOBJ 

MATERIAL 

ENDOBJ 

coordinate  system 

0 0 0 

9 17 
7 

KAPTON 


The  coordinate  system  may  be  adjusted  with  the  OFFSET  command  anytime 
at  any  point  between  building  blocks.  The  active  system  is  always  the 
default  or  the  coordinate  system  defined  by  the  most  recent  OFFSET. 

Not  all  inner  grids  need  be  33  points  long  in  the  Z direction.  The 
number  of  points  may  be  chosen  to  be  any  integer  of  the  form  (4n+l), 

4 £ n _<  8,  by  the  user  as  a run  option  (6.4.8).  If  the  Z axis  is 
chosen  to  be  NZ  points  long  then  the  default  coordinate  system  runs 
from  -(NZ-l)/2  (rounded  down)  to  +(NZ-l)/2. 
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3.9.4 


CONDUCTOR 


NASCAP  allows  for  both  insulating  and  conducting  materials 
(Chapter  4).  It  assumes  that  all  surface  materials  cover  an 
underlying  conductor.  Up  to  15  separate  conductors  are  allowed.  Each 
building  block  is  associated  with  a particular  conductor.  This 
association  is  made  by  preceding  all  building  block  definitions 
associated  with  the  first  conductor  with  the  card: 

CONDUCTOR  1 

Similarly,  blocks  associated  with  a second  conductor  are  preceded  by 
the  card 

CONDUCTOR  2 

and  so  on.  If  no  CONDUCTOR  card  is  included  in  the  object  definition 
file  all  building  blocks  will  be  associated  with  CONDUCTOR  1.  In  the 
same  way  any  building  blocks  defined  before  OBJDEF  encounters  a card 
CONDUCTOR  n (n  > 1) 

will  be  associated  with  conductor  1.  All  subsequent  blocks  will  be 
associated  with  conductor  n,  until  another  conductor  card  is 
encountered. 

It  is  conventional  to  choose  conductor  1 as  the  satellite  ground 
conductor.  Skipping  conductor  numbers  is  not  recommended. 

3.9.5  DELETE 

DELETE  allows  the  user  to  modify  building  blocks  already  defined 
by  selectively  "deleting"  filled  or  partially  filled  cells  (i.e., 
"deleting"  them  by  making  them  empty). 

DELETE  x y z 

empties  the  filled  cell  with  the  indices  of  its  lowest  index  vertex 
given  by  x y z.  (The  lowest  index  vertex  is  the  one  with  the  sum  of 
its  X,  Y and  Z coordinates  equal  to  the  least  positive  number.)  The 
coordinates  x,  y,  z refer  to  the  coordinate  system  presently  active 
(i.e.,  the  default  system  or  that  associated  with  the  most  recent 
OFFSET  command).  The  DELETE  command  requires  great  care  in  its  use. 
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It  does  not  assign  materials  to  surfaces  that  are  newly  exposed  by  the 
removal  of  a filled  element.  The  user  must  do  this  by  defining  a new 
object  or  objects  with  surfaces  that  coincide  with  those  newly 
exposed.  This  is  most  easily  done  by  overlaying  objects  (4.8). 

3.9.6  OTHER  WORDS 

Any  other  words  that  OBJDEF  reads  in  the  object  definition  file 
are  assumed  to  be  the  names  of  new  materials  and  OBJDEF  then  expects 
four  more  cards  defining  the  material  properties  (4.4)  to  follow 
immediately. 

3.10  SURFACE  CELLS 

The  exposed  faces  of  the  filled  volume  elements  (or  of  the 
partially  filled  portions  of  the  partially  filled  elements)  that  make 
up  an  object  are  called  the  surface  cells.  Surface  cells  combine  to 
form  the  surface  area  of  the  object.  Each  surface  is  characterized  by 
the  following  information: 

1.  Index  (number)  of  underlying  conductor. 

2.  X,  Y,  and  Z coordinates  of  the  volume  cell  with  which  it  is 
associated. 

3.  The  direction  of  its  surface  normal  (in  np  n^,  n^ 

notation,  e.g,  1 -1  0). 

4.  Material  number  (assigned  to  each  material  in  order  of  their 
definition) . 

This  information  uniquely  determines  each  surface  cell.  NASCAP 
assigns  a number  to  each  cell  based  on  these  properties.  The  cells 
are  numbered  sequentially  from  the  lowest  indexes  to  the  highest,  with 
property  4 changing  most  rapidly  and  property  1 least  rapidly.  This 
surface  cell  list  is  printed  out  by  NASCAP. 

Only  four  types  of  individual  surface  cells  are  possible.  They 
are  the  faces  of  the  four  possible  filled,  or  partially  filled,  volume 
elements.  They  are  illustrated  in  Figure  3.17. 
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1 . Square 


3.  Equilateral  Triangle 
(face  of  a tetra- 
hedron) 


Figure  3.17.  Four  types 


2.  Half  Square 


4.  Rectangle 

(face  of  wedge) 


of  surface  cell 
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3.11  DEFINING  AN  OBJECT 


3.11.1  EXAMPLE:  SOLID  OBJECT 

The  input  file  of  Figure  3.18  defines  an  object  consisting  of  an 
ALUMINUM  slab,  trimmed  with  four  KAPTON  wedges  and  four  TEFLON 
tetrahedra,  and  topped  with  a GOLD  sphere.  Three  views  of  the 
resulting  object  are  shown  in  Figure  3.19. 

3.11.2  EXAMPLE:  TRANSPARENT  ANTENNA 

Figure  3.20  is  an  object  definition  input  showing  how  the  three 
types  of  mesh  cells  may  be  joined  together  to  make  a dish- like 
antenna.  HIDCEL  plots  of  this  object  are  shown  in  Figure  3.21. 

Figure  3.22  shows  the  same  antenna  mounted  on  a spacecraft. 
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1. 
2. 
3 • 
4. 


5. 

6 m 

7. 

3. 

9. 

ID. 
11  . 
12. 

13. 

14. 

15. 
16  • 
17. 
19. 
19. 
20  • 
21. 
22. 

23. 

24. 

25. 

26. 

27. 

28. 
29. 
3D. 


34. 

35. 

36. 

37. 

38. 

39. 
4D. 

41. 

42. 

43. 

44. 


45. 
^ 6 • 
47. 
4 c • 
49. 


51  . 

52. 

53. 

54. 

55. 

56. 

57. 
53. 
59. 
60  . 
61. 
be. 

63. 

64. 

65. 


COMMENT  ALUMINUM  SLAE  - 

=ECT6N 

CORNER  -3  -4  -1 
DELTAS  6 8 1 
SUPFACE  *2  ALU"IN'UM 
SURFACE  -2  ALUMI\UM 
EMCOR„ 

COMMENT  FOUR  KAFTCN  LECC-ES  = 

■EDGE  j 

CORNER  -3  -4  -I 
FACE  KAPTON  -1  C 1 
LENGTH  1 3 1 
SURFACE  -2  HAPTCN 
ENOOBJ 
WEDGE 

CORNER  -3  -4  -1 
FACE  KAPTON  C -1  1 
LENGTH  611 
SURFACE  -2  KAPTCN 
ENOOEJ 
WEDGE 

CORNER  3 -«  -1 
FACE  KAPTON  ID! 

LENGTH  181 
SURFACE  -2  KAPTCN 
ENCOS J 
WEDGE 

CORNER  -3  4 -i 
FACE  KAPTON  Dll 
LENGTH  6 1 1 
SUPFACE  -2  KAPTCN 
ENDOE J 

COMMENT  FOUR  TEFLCN  TETRAHEDRA  = 

TETRAHEDRON 

CORNER  -3  -4  -1 
FACE  TEFLCN  -1  -1  1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOOBJ 

tetrahedpcn 

CORNER  3 -4  -1 
FACE  TEFLCN  1-11 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOCBJ 
TETRAHEDRON 

CORNER  34-1 
FACE  TEFLCN  1 1 1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOOBJ 
f ETRAhECRCN 

CORNER  - 2 4 -l 
FACE  TEFLCN  -1  1 1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENGOS J 

COMMENT  ALL  TCPPEC  BV  A GOLD  SPHERE^ 
CSPHERE 

CENTER  C C 2 
DIAMETER  4 
SICE  2 

MATERIAL  GCLC 
ENCOBJ 

ENDSAT  J 


CUBOID 


FOUR  WEDGES 


FOUR 

TETRAHEDRA 


SPHERE 


Figure  3.18.  Object  definition  example. 


Figure  3.19.  Three  views  of  object  defined  by  input  of  Figure  3.18 


CO-KENT 

OFFSET 

plate 

ASLANT 

ASLANT 

ASLANT 

ASLANT 

ATET 

ATET 

ATET 

ATET 

ENDSAT 


DISH  ANTENNA 
9 9 12 

CORNER  -2  -2  0 
DELTAS  4 4 C 
ANTENNA  GOLD 
ENDOBJ 

CORNER  2-23 
FACE  GOLD  1 C -1 
LENGTH  343 
END03J 

CORNER  -2  -2  3 
FACE  GCLD  -1  C -1 
LENGTH  343 
ENDOPJ 

CORNER  -2  -2  3 
FACE  GOLD  0 -1  -1 
LENGTH  433 
ENDOPJ 

CORNER  -223 
RACE  GOLD  0 l -1 
LENGTH  433 
END03J 

CORNER  223 
FACE  GOLD  I 1 -1 
LENGTH  3 
ENDOPJ 

COPNEP  -223 
FACE  GOLD  -I  1 -1 
LENGTH  3 
ENDOBJ 

CORNER  -2  -2  3 
FACE  GOLD  -1  -I  -1 
LENGTH  3 
ENDOBJ 

CORNER  2-23 
FACE  GOLD  1 -1  -1 
LENGTH  3 
ENDOBJ 


Figure  3.20.  Object  definition  input  for  a dish-like  antenna. 
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74-4 


Figure  3.21.  Three  views  of  the  dish-like  antenna  defined  by  Figure  3.20. 
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Figure  3.22.  Three  views  of  the  dish-like  antenna  (previous  two  figures)  mounted  on  a spacecraft. 


3.12  LIMITATIONS  IN  OBJECT  DEFINITION 


It  is  probably  fair  to  say  that  you  can  link  building  blocks 
together  and  nine  times  out  of  ten  there  will  not  be  a problem.  This 
section  deals  with  the  other  one  time  out  of  ten,  when  what  appears  to 
be  a perfectly  reasonable  combination  of  building  blocks  is  rejected 
by  OBJDEF.  We  itemize  here  a rather  formidable  list  of  object 
definition  "don'ts".  However,  you  should  remember  that  it  takes  hard 
work  to  break  more  than  one  or  two  of  these  rules  defining  any  one 
object  if  you  use  a little  common  sense. 


1.  All  exposed  surfaces  must  be  assigned  materials. 

2.  The  parameter  cards  for  each  building  block,  discussed  in 
Section  3.8,  must  appear  in  the  order  shown,  and  no  other. 

3.  No  surface  may  lie  in  the  planes  that  form  the  boundary  of  the 
inner  mesh.  Surfaces  may  touch  the  boundary  planes  at  a point 
or  line. 

4.  Booms  may  not  lie  in  the  boundary  planes.  Booms  may  cross  a 
boundary  plane  but  only  from  an  inner  to  an  outer  grid  and  not 
vice  versa. 

5.  Booms  may  not  lie  along  the  edges  of  filled  or  partially  filled 
volume  elements  or  pass  through  objects. 

6.  Two  booms  may  not  share  the  same  volume  element;  i.e.,  two 
parallel  booms  must  be  at  least  two  grid  units  apart,  and  two 
perpendicular  booms  may  not  intersect. 

7.  Thin  plates  sharing  the  same  volume  element  can  do  so  only  if 
the  TOP  face  of  one  shares  volume  with  the  TOP  of  the  other,  or 
the  BOTTOM  face  of  one  shares  volume  with  the  BOTTOM  face  of  the 
other.  TOP  faces  may  not  share  volume  elements  with  BOTTOM 
faces. 
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8. 


Thin  plates  may  only  intersect  each  other  at  the  edges  or 
corners. 

9.  Double  points  must  be  assigned  TOP  and  BOTTOM  sets  (see  Section 
3.13). 

10.  A boom  cannot  share  a volume  element  with  the  BOTTOM  of  a thin 
plate. 

(Rules  7 through  10  are  all  manifestations  of  conflicts  involving 
double  and  triple  points.) 

3.13  DOUBLE  POINTS 

Thin  plates  may  have  different  potentials  on  their  two  surfaces, 
yet  they  occupy  only  one  plane  of  grid  points.  These  grid  points  must 
therefore  be  associated  with  two  distinct  sets  of  potentials.  For 
this  reason  they  are  called  double  points.  The  two  sets  of  potentials 
associated  with  each  half  of  the  double  points  are  distinguished  by 
calling  one  set  'TOP'  and  one  set  'BOTTOM'.  Recall  (3.8.9)  that  the 
surfaces  of  a thin  plate  may  be  defined  as  'TOP'  or  'BOTTOM' 
regardless  of  whether  their  surface  normal  points  along  a positive  or 
negative  axis  direction:  The  TOP  and  BOTTOM  definition  refers  to  the 

(arbitrary)  choice  of  which  set  of  potentials  (TOP  or  BOTTOM)  to 
associate  with  each  surface.  When  double  points  share  a volume 
element  they  must  all  be  of  the  same  type;  i.e.,  all  TOP  or  all 
BOTTOM.  This  is  the  basis  for  rule  7 in  Section  3.12. 

Double  points  also  occur  when  other  building  blocks  touch  in 
such  a way  that  their  single  points  come  together  to  form  a common 
vertex  of  two  "disjoint"  volume  elements.  By  "disjoint"  volume 
elements  we  mean  elements  physically  separated  from  each  other  by 
solid  surfaces.  This  is  shown  for  two  cuboids  touching  along  one  edge 
only  in  Figure  3.23.  The  row  of  points  along  the  touching  edges  are 
double  points  and  one  set  must  be  defined  as  BOTTOM.  This  may  be  done 
by  defining  a thin  plate  touching  the  common  edge.  If  the  exterior 
surface  of  the  plate  pointing  into  one  of  the  disjoint  volumes  is 
'BOTTOM'  then  the  half  of  the  double  point  associated  with  the  other 
disjoint  volume  becomes  'TOP'. 
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Because  of  the  way  surface  cell  potentials  are  assigned  to  the 
grid  points  the  edges  of  thin  plates  are  only  single  points.  However, 
a thin  plate  touching  another  building  block  (not  BOOMsJ)  with  its 
edge  creates  a row  of  double  points  similar  to  that  caused  by  two 
cuboids  touching  at  an  edge  (Figure  3.24).  These  double  points  are 
automatically  assigned  TOP  and  BOTTOM  sets. 

3.14  TRIPLE  POINTS 

A triple  point  is  said  to  occur  when  a vertex  is  common  to  three 
or  more  disjoint  volume  elements.  Triple  points  are  illegal.  The 
easiest  way  to  get  a triple  point  is  to  define  one  thin  plate  passing 
through  another.  This  is  not  allowed  (rule  8,  Section  3.12). 

3.15  TECHNICAL  DISCUSSION 

Here  we  examine  some  of  the  technical  details  of  how  NASCAP 
actually  calculates  potentials,  and  treats  volumes  and  surfaces.  The 
casual  user  may  wish  to  omit  this  section. 

3.15.1  CONJUGATE  GRADIENT  POTENTIAL  SOLVER 

Consider  a charged  object  isolated  in  space.  The  potential  i 
everywhere  is  given  by  the  solution  to  Poisson  s equation 


V(6  = -p/e 


(3.1) 


The  variational  principle^  associated  with  this  equation  is  given 
by: 


<5 

7? 


\(f* v>*>2^)  ♦/ 

SL  ds  + f t • d*dS' 

cs 

CB 

= o 
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Bottom 


where  we  integrate  over  both  the  object  and  boundary  surfaces  (c<-, 
CB)* 

To  simplify  things  for  the  purpose  of  illustration,  let  us  fix 
the  potentials  on  these  surfaces  and  assume  zero  charge  density.  The 
equation  then  simplifies  to 

Ij  /dV  | (Vi)i 2  = 0 (3.2) 


Equation  (3.2)  involves  an  integral  over  the  volume  of  the 
computational  space.  One  way  to  treat  this  integral  is  to  divide  the 
space  up  into  finite  cubic  volume  elements. 

ydv|(v«)2>2  / dVe  £ (V<S)2 * 
e Ve 

In  this  approach  the  potential  t is  defined  at  each  grid  point,  or 
node,  defining  the  vertices  of  the  elements.  The  potential  inside 
each  element  is  then  tri linearly  interpolated  from  the  values  of  each 
of  its  eight  vertices. 

ie  (x,y,z)  = 23  NiXyZ  *i 

i £ e 

where  "i"  are  the  nodes  of  element  "e" 

V*>6  (x,y,z)  = VNn.xyz  4>. 
i 

and 

/dV  \ (V*)2  = 23  /dVe  | S VN^(x,y,z)0i|2 

e i 
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The  quantity 


= f dV  VN^2  -VN?yz 
J e i j 

e 


(3.3) 


Is  completely  defined  just  by  knowledge  of  the  shape  of  the  element 
"e"  (i.e.,  whether  the  cube  is  empty  or  partially  filled).  The 
variational  principle  therefore  becomes: 


<5 

71 


2 2 Wij  *i  * j ' 0 


(3.4) 


Let  J)  M.j. 


Equation  (3.4)  becomes 


•5 

71 


> . d-M. .d. 
- ij 


° = M 


Thus  the  set  of  d values  at  each  node  ( d ) that  satisfy  M d is  the 
solution  to  the  Poisson  equation  (3.1)  under  conditions  of  fixed 
object  and  boundary  potentials  and  zero  charge  density. 

We  may  solve  Eq.  (3.4)  iteratively.  Our  initial  choice  of  d 
will  yield  a residual  r 

M d = -r 
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The  iterative  scheme  used  is  the  Scaled  Conjugate  Gradient  technique. 

[3] 

It  is  based  on  the  following  equations: 

r = -M  p 

~o  ~ ~o 


iMij 


,-1/2 


"J 


d 


M$  = D M D 

Then  solve  iteratively: 

A ■ ri)/<us*  ms  ui> 


(D-1p)1+1  . (O'1?)1  + a1  p1 


p1+1  = r1  - a1  M u1 
S X $ s s 


bs  * "-r* 


u1+1  . r1+1  + b1  u1 
s s s s 


until  r reaches  a small  value  and  the  resultant  p vector: 


pn  = D (D_1  p)n 


becomes  the  solution  to  Poisson's  equation. 

The  major  computational  operation  in  the  iterative  set  of 
equations  is  the  evaluation  of  the  matrix- vector  product  M u.  The 
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vectors  p,  u,  and  r all  have  the  same  number  of  elements  as  the  number 
of  grid  points.  M contains  the  square  of  this  number.  Such  a huge 
array  is  impractical  to  store  all  at  once  and  so  M u is  evaluated 
using  the  following  implicit  algorithm 

I’Sre'Sse'i 

e e 

The  residual  r is  constructed  element  by  element  (where  the  Wg 
matrix  is  only  8x8)  and  then  summed.  The  8x8  "weight"  matrices 
w may  be  calculated  analytically  for  each  type  of  empty  or 
partially  filled  volume  element,  allowed  by  NASCAP.  There  are  five  of 
these.  Filled  cells  are  not  included  in  the  potential  calculation. 
This  is  how  NASCAP  treats  filled,  partially  filled  and  empty  elements, 
differently. 
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3.15.2 


STANDARD  VOLUME  CELLS 


The  five  standard  cells  are  summarized  below. 


(Format) 

Description 
Standard  Orientation 

V"'  i 

Potential  Function  = N 

i 1 

Weight  Matrix,  W. . : /d ^ I Vjtf ] ^ = xC  U..6.6. 

■ J J 4 4 !J  1 J 


Point  Index 
1 
2 

3 

4 

5 

6 

7 

8 


Cube  Corner 
0 0 0 
1 0 0 
0 1 0 
1 1 0 
0 0 1 
1 0 1 
0 1 1 
1 1 1 
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Standard  Cell  0 
Empty  tri linear  cube 
Orientation:  Arbitrary 

Potential  Function: 

1 
1 

2 

3 

4 

5 

6 

7 

8 

Wij 

1/3 


0 

0 

-1/12 

1/3 

-1/12 

0 

1/3 

0 

1/3 

0 

-1/12 

-1/12 

-1/12 

-1/12 

0 

-1/12 

-1/12 

-1/12 

-1/12 

0 

-1/12 

-1/12 

-1/12 

-1/12 

0 

(l-x)(l-y)(l-z) 

(l-z)(l-y)x 

(l-x)y(l-z) 

(l-z)yx 

z(l-yMl-x) 

x(l-y)(z) 

zy(l-x) 

xyz 


1/3 

0 1/3 

0 -1/12  1/3 

-1/12  0 0 1/3 
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Standard  Cell  1 
Half-Empty  Wedge 

1 < x + y < 2 
0 < z < 1 


Orientation:  Right  angle  along  line  4-8 

Potential  Function: 


i 

N1 

1 

0 

- 

2 

(l-y)d-z) 

3 

(l-x)(l-z) 

4 

(x+y-l)(l-z) 

5 

0 

- 

6 

(i-y)z 

7 

d-x)z 

8 

(x+y-l)z 

Wij 

0 

0 

1/4 

0 

1/24 

1/4 

0 

-1/8 

-1/8 

5/12 

0 

0 

0 

0 

0 

0 

0 

-1/24 

-1/8 

0 

1/4 

0 

-1/24 

0 

-1/8 

0 

1/24  1/4 

0 

-1/8 

-1/8 

-1/12 

0 

-1/8  5/12 

87 


Standard  Cell  2 

Cube  with  diagonal  line  on  one  face 
Orientation:  Line  from  2 to  3 

Potential  Function: 


1 

2 

3 

4 

5 

6 
7 


( 1-x-y ) ( 1-z ) e ( 1-x-y ) 

[x  (l-x-y)+(l-y)e(x+y-l)](l-z) 
[y  ( 1-x-y )+(l-x)e(x+y-l)](l-z) 
( x+y-1 ) ( 1-z ) e ( x+y-1 ) 

( 1— x)  ( 1— y)  z 

x(l-y)z 

(l-x)yz 


8 


xyz 


ij 

5/12 

-1/8  1/2 

-1/8  1/12  1/2 

0 -1/8  -1/8  5/12 

7/360  -37/360  -37/360  -23/360  1/3 

-11/180  -1/45  -19/180  -11/180  0 1/3 

-11/180  -19/180  -1/45  -11/180  0 -1/12  1/3 

-23/360  -37/360  -37/360  7/360  -1/12  0 0 1/3 
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Standard  Cell  3 
Tetrahedron 


2<x+y  + z<3 

Orientation:  Empty  corner  at  point  8 

Potential  Function: 


1 
1 

2 

3 

4 

5 

6 

7 

8 


0 

0 

0 

1-z 

0 

i-y 

l-x 

x+y+z-2 


0 

0 0 

0 0 0 

0001/6 
0 0 0 0 0 

0 0 0 0 0 

0 0 0 0 0 

000  -1/6  0 


1/6 

0 1/6 

-1/6  -1/6 


1/2 


0 

0 5/12 

0 1/72  5/12 

0 -11/120  -37/360  13/36 

0 1/72  1/72  -1/9  5/12 

0 -37/360  -1/9  -7/180  -11/120  13/36 

0 -1/9  -11/120  -7/180  -37/360  -7/180  13/36 

0 -5/36  -5/36  1/45  -5/36  1/45  1/45  7/20 
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Additional  Standard  Cells: 

Standard  cell  5 (not  treated  by  NASCAP/GEO)  is  a cube  divided 
into  two  wedges  by  a slanted  thin  plate.  In  standard  orientation,  the 
"top"  half  corresponds  to  the  empty  portion  of  standard  cell  1. 

Standard  cell  6 is  a cube  divided  into  two  wedges  by  a slanted 
rectangular  transparent  antenna  cell.  It  is  treated  by  the  potential 
solver  as  two  complementary  type  1 cells. 

Cells  containing  equilateral  triangle  antenna  surfaces  are 
treated  by  the  potential  solver  as  empty  (type  0)  cells. 
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3.15.3 


VOLUME  ELEMENT  TABLE 


• Information  concerning  each  volume  element  is  stored  in  file 
ILTBL  (Chapter  2).  Each  entry  is  bit  coded  as  follows: 

CODE  FOR  ELEMENT  TABLE  [LTBL(NX,NY,NZ) ] 

5 [432]  110987654321]  0 9 8 7 65  |432109876|  5 [43210 1 


H 

G F E D C B A 

Field 

Bits 

A 

4-0 

E It- type  code 

5 

(Not  used) 

B 

14-6 

Orientation  code 

16-15 

(Not  used) 

C 

17 

Set  for  cells  bordering  the  "TOP"  surface  of 
"PLATE" 

D 

18 

Set  if  elt  is  completely  filled  (interior) 

E 

19 

Set  for  an  empty  special  (type  2)  elt 

F 

20 

Set  for  cells  bordering  the  "BOTTOM"  surface 
of  a "PLATE" 

G 

31-21 

Index  used  to  reference  BEAMJ  array  to 
determine  emitter  currents 

H 

34-32 

Number  of  surfaces  pointing  into  volume  cell 

ORIENTATION 

CODE 

The  orientation  code  is  a nine-bit  (three  octal  digit)  code 
describing  how  a non-symmetric  element  may  be  transformed  into  its 
"standard"  orientation.  The  transformation  (consisting  of  rotations, 
inversions,  and  translations)  to  the  "standard"  orientation  is  that 
transformation  which  takes  vector  r into  vector  s,  where 

r = (*,y,z) 

s = (qO^),  q(i2),  q(i3)) 


PRECEDING  PAGE  BLANK  NOT  FILMED 
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ij  Is  the  octal  digit  in  bits  14-12 

i2  is  the  octal  digit  in  bits  11-9 

i^  is  the  octal  digit  in  bits  8-6 

q ( 1 ) * x q( 5)  = 1-x 

q(2)  = y q(  6)  = 1-y 

q(3)  = z q(  7)  = 1-z 

For  example,  the  octal  code  365  implies  the  transformation 


3.15.4  SURFACE  CELL  POTENTIALS 

The  potentials,  charge  densities,  etc.  are  stored  in  17  x 17  x 33 
arrays  for  each  grid,  with  an  entry  for  each  grid  point  in  free 
space.  In  addition,  a separate  list  of  potentials  for  each  surface 
cell  is  kept  (Table  2.6).  The  entries  in  the  potential  array  for  the 
grid  points  lying  on  the  surface  of  the  object  are  calculated 
determined  by  the  potentials  in  the  surface  potential  list.  Each  grid 
point  belonging  to  a surface  cell  Is  assigned  an  "area  weighted" 
proportion  of  that  cell's  potential.  The  final  potential  of  the  grid 
point  is  then  the  sum  of  contribution  from  all  the  surface  cells 
touching  it.  The  area  weights  are  given  by  the  area  of  the  cell 
divided  by  the  number  of  points  defining  the  area;  e.g.,  a point  at 
the  corner  of  a square  cell  has  a weight  of  0.25. 
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3.15.5 


SURFACE  CELL  LIST 


In  addition  to  an  element  table  list,  bit-coded  information 
concerning  each  surface  cell  is  stored  in  array  JSURF,  the  surface 
cell  test.  (This  resides  in  random  access  file  ICNOW,  see  Chapter  2.) 
The  bit  coding  convention  is  shown  in  Figure  3.25. 


1 43 1 [2109  | 1 87654  | [321098 


|3210[ 


H6  F E D CBAAA 

Field  Bits 

A 3-0  Material  index 

AA  4 Set  for  transparent  antenna  surface 

B 5 Set  for  right-triangular  100  surfaces  and  for  111 

surfaces  whose  enclosing  volume  cell  is  mostly  empty 

C 11-6  Direction  of  surface  normal  (in  crystallographic 

notation) 

D 17-12  Z-coordinate 

E 23-18  Y-coordinate 

F 28-24  X-coordinate 

G 32-29  Conductor  index 

H 34-33  Orientation  code  for  right-triangular  100  surfaces 


Figure  3.25.  Surface  cell  list  (JSURF)  entry  format. 

Notes: 

A - Gives  the  material  number.  Materials  are  numbered 

sequentially  as  encountered  in  the  object  definition  file. 
Up  to  15  materials  are  actually  allowed  (leaving  one  bit 
spare) . 
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C - Two  bits  are  taken  for  each  crystallographic  index.  The 

rightmost  of  the  pair  for  1,  0,  the  leftmost  for  + (set  for 
mi  nus) . 

D,E,F  - The  X,  Y,  Z coordinates  refer  to  the  lowest  index  or  vertex 
of  the  associated  volume  cell  (the  one  whose  sum  of  X,  Y,  Z 
coordinates  would  be  least  positive).  The  associated 
volume  cell  is  the  cell  containing  a slanted  surface,  or 
out  of  which  the  surface  points. 

G - Conductor  number  - from  1 to  15. 

H - The  two  bits  define  the  location  of  the  right  angled  corner 

in  the  plane  of  the  triangle,  i,  j. 


i 


The  rightmost  bit  refers  to  j.  If  i and  j are  related  to 
the  direction  of  the  surface  normal  as  follows 


Normal  j_  _j 

Z X Y 

X Y Z 

Y Z X 
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3.15.6 


GEOMETRICAL  ANALYSIS  OF  OBJECTS 


Following  completion  of  an  object  definition,  NASCAP 
automatically  invokes  the  routine  GENMTL  to  perform  a detailed 
geometrical  analysis  of  the  defined  object.  Among  the  functions 
performed  are: 

1.  Verifying  that  every  edge  (of  a surface  cell)  has  a surface  on 
either  side. 

2.  Determining  multiple-defined  points.  (Consider  a path 
connecting  surface  cells  of  which  the  point  is  a vertex  and 
circumnavigating  the  point.  If  there  is  only  one  such  path,  the 
point  is  a "single"  point.  If  two  paths,  it  is  a "double" 
point.  More  than  two  paths  make  the  point  illegal.)  When 
double  points  are  found,  it  is  verified  that  there  is  no 
ambiguity  between  "top"  and  "bottom". 

When  object  definition  errors  are  found,  a message  is  printed 
indicating  the  approximate  location  (in  absolute  coordinates)  of  the 
error.  Some  errors  are  fatal,  and  others  merely  warnings.  These 
warnings  should  be  taken  very  seriously.  The  object  definition 
graphics  (obtainable  through  the  module  SATPLT)  are  often  helpful  in 
identifying  the  error. 

In  the  process  of  performing  this  analysis  GENMTL  forms  and 
outputs  (to  file  ICNOW)  several  lists  for  later  use  in  NASCAP.  These 
are: 

PTLIST  - List  of  points  which  are  vertices  of  insulating  surface  or 

boom  cells;  in  format 

C + 64*((D+2*(B+2*(V+2*E))) 

+ 64*(Z+64*(Y+64*(X+64*G)))). 

C = conductor  number  of  all  neighboring  cells  have  same 
underlying  conductor;  otherwise  C = 0. 

D = 1 for  double  point;  0 otherwise. 

B = 1 for  bottom  point;  0 otherwise. 

V = 0. 
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E = 1 if  point  is  vertex  of  a conducting  surface  cell; 
E = 0 otherwise. 


X,  Y,  Z are  "absolute"  [1-17,  1-17,  1-33]  coordinates  of 
point. 


G = grid  number  (boom  nodes  only). 

CPU  ST  - List  of  vertices  of  surface  cells  which  do  not  appear  in 

PTLIST.  Same  format  as  PTLIST,  except  V = 1. 

DPTLST  - List  of  double  points  in  format  Z + 64*(Y+64*X). 

LINS  - List  of  insulating  surface  and  boom  cells,  in  format 

C + 4096*CELLN0. 


C = underlying  conductor  number. 

CELLNO  = surface  cell  number  or  NSURF  + boom  cell  number. 

VTXL  - Vertex-surface  cell  list  to  be  used  by  subroutine  REFIX. 
Format  is 

2^*[PTLIST  index]  + [LINS  index]. 

Each  entry  in  the  PTLIST  produces  an  entry  in  VTXL  for  each 
surface  or  boom  cell  of  which  it  is  a vertex.  For 
conducting  cells,  [LINS  index]  is  replaced  by  NINS  + 
[conductor  number],  where  NINS  is  the  length  of  LINS. 

SCLIST  - Surface  connectivity  map.  Contains  a negative  number  for 
each  LINS  entry  and  each  conductor.  Each  negative  number 
is  followed  by  positive  numbers  indicating  LINS  entries  or 
conductors  to  which  the  negative  index  is  linked  by  bulk  or 
surface  conductivity. 

SCMAT  - Intrinsic  surface  and  bulk  conductivity  matrix,  ordered  as 
SCLIST,  with  diagonal  elements  in  positions  corresponding 
to  negative  SCLIST  entries. 


Some  of  the  highlights  of  those  lists  (such  as  their  length) 
will  be  printed  as  GENMTL  is  executed.  Additionally,  if  'PRINT 
OBJDEF'  is  specified,  the  full  PTLIST,  CPTLST,  and  DPTLST  will  be 
printed. 
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4.  MATERIAL  PROPERTIES 


4.1  SURFACES,  CURRENTS  AND  CHARGING 


An  object  exposed  to  a neutral  plasma  may  charge  electrostatic- 
ally as  charged  particles  (electrons  and  ions)  collide  with,  and 

collect  on,  the  surface.  At  geosynchronous  altitudes  the  ambient 
plasma  consists  of  electrons  and  ions  with  similar  distributions  of 
energy.  Since  electrons  are  almost  2000  times  less  massive  than  the 
lightest  ions,  this  means  that  the  particle  velocity  distributions  are 
not  similar,  and  the  electron  flux  (or  current)  incident  on  an  exposed 
surface  greatly  exceeds  (by  a factor  of  A836  = 43)  the  incident  ion 
flux.  If  incident  electron  and  ion  currents  were  the  only  source  of 
charge,  all  surfaces  exposed  to  such  plasmas  would  rapidly  acquire  a 
negative  potential.  However,  there  are  several  other  contributions  to 
the  overall  net  current  to  the  surface.  These  include: 

1.  Secondary  emission  due  to  primary  electron  impact,  i|. 

2.  Secondary  emission  due  to  ion  impact,  i^. 

3.  Backscattered  primary  electrons,  ib. 

4.  Photoemission  due  to  UV  illumination  (sunlight),  iP. 

5.  Conductivity  (bulk  and  surface),  ic. 


NASCAP  takes  all  of  these  sources  of  current  into  account,  as  well  as 
the  incident  primary  currents,  in  calculating  the  net  current  to  each 
surface  cell.  The  mechanism  for  each  source  is  discussed  in  detail  in 
Section  4.8.  If  ifi  and  i are  the  incident  primary  electron  and 
ion  currents,  respectively,  the  net  current  i t to  a particular 
surface  cell  is  given  by  the  equation: 


i = i + i + is  + is  + ib  + ip  + ic 
net  e p e p 
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In  most  cases  the  incident  electron  current  1 is  the  only  negative 
contribution.  Secondary  emission,  backscatter  and  photoemission  are 
sources  of  positive  current  since  they  involve  the  ejection  of  elec- 
trons from  the  surface  back  to  the  plasma.  The  incident  ion  flux 
(ip)  is  also  a source  of  positive  current  but  the  secondary  emission 
(plus  photoemission  in  sunlight)  forms  the  dominant  contribution.  Thus 
the  sign  of  the  net  current  1 t depends  mainly  on  the  balance 
between  the  secondary  emission  current  (plus  photoemission)  and  the 
incident  electron  current. 

When  i‘e  exceeds  1*  (+i^)  the  net  current  is  negative 
and  the  surface  will  begin  to  acquire  a negative  potential.  As  the 
surface  becomes  negatively  charged  both  the  secondary  emission  and  the 
incident  electron  current  are  modified.  The  effect  is  to  attenuate 
the  net  negative  current  and  the  rate  of  charging  declines.  This 
continues  until  inet  = 0 and  an  equilibrium  surface  potential  is 
reached.  Equilibrium  potentials  of  up  to  -10  kV  have  been  observed  in 
geosynchronous  orbit. 

When  i is  exceeded  by  is  (+i  ) so  that  the  net  current 
e e p 

is  positive,  then  the  surface  begins  to  acquire  a positive  potential. 
However,  large  equilibrium  positive  potentials  are  not  observed.  This 
is  because  the  secondary  emission  and  photoemission,  which  form  the 
dominant  contribution  to  the  positive  current,  have  low  energy 
( <10  eV).  As  soon  as  the  surface  potential  approaches  a few  eV 
positive  the  low  energy  emission  can  no  longer  escape  and  is 
suppressed.  This  causes  rapid  attenuation  of  i t and  equilibrium 
is  achieved.  Since  an  equilibrium  of  just  a few  volts  positive  is 
negligible  compared  with  potentials  of  kilovolts  that  are  typical  of 
negative  charging,  surfaces  with  net  positive  currents  are  often  said 
to  "not  charge"  or  "remain  neutral". 


4.2  SURFACE  CURRENTS  AND  MATERIAL  PROPERTIES 


Clearly  it  is  important  for  NASCAP  to  include  contributions  from 
all  of  the  important  surface  current  sources  mentioned  in  4.1. 

Currents  due  to  secondary  emission,  photoemission,  backscatter,  etc. 
all  depend  strongly  on  the  nature  of  the  material  covering  the 
surface.  (The  mechanisms  for  all  of  these  current  sources  are 
explained  in  Section  4.8.) 

For  NASCAP  to  include  realistic  estimates  of  these  currents  in 
its  calculations  it  must  allow  surface  cells  to  be  assigned  different 
materials.  In  Chapter  3 we  saw  how  object  definition  required  a 
material  name  to  be  assigned  to  each  exposed  surface.  NASCAP  makes 
the  connection  between  each  material  name  and  their  different  surface 
currents  via  a list  of  material  properties. 

4.3  MATERIAL  PROPERTIES 

Each  material  name  (e.g.,  KAPTON,  GOLD,  FRED  (the  name  is 
arbitrary))  has  associated  with  it  a list  of  material  properties.  The 
name  of  each  material  and  the  values  for  each  material  property  are 
supplied  by  the  user  in  the  object  definition  file.  (This  is 
explained  in  Section  4.4.)  The  nineteen  material  properties  are 
summarized  in  Table  4.1.  Here  we  examine  each  one  in  more  detail. 

4.3.1  DIELECTRIC  CONSTANT  (PROPERTY  1) 

Property  1 contains  the  relative  dielectric  constant  for  an 
insulating  material  er 


£ 


where  e is  the  absolute  dielectric  constant  and  cQ  is  the  dielectric 
constant  of  free  space.  er  is  dimensionless. 
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TABLE  4.1.  MATERIAL  PROPERTIES 
(see  Section  4.3  for  notes) 


Property  No. 

User  Input  Units 

Description 

1 

None 

Relative  dielectric  constant 

2 

m 

Dielectric  material  thickness 

3 

ohms-!  m-! 

Bulk  conductivity  (=  -1  for  a 
metallic  conductor) 

4 

None 

Atomic  number 

5 

None 

Maximum  secondary  electron  yield 
for  electron  impact 

6 

keV 

Primary  electron  energy  that 
produces  maximum  secondary  yield 

7 

8 

9 

10 

angstroms 

None 

angstroms 

None 

( Range  parameters  (4.3) 
( R = P7EP8  + PgEP!0 

11 

None 

Secondary  electron  yield  due  to 
impact  of  1 keV  protons 

12 

keV 

Incident  proton  energy  that 
produces  maximum  secondary  electron 
yield 

13 

A m-2 

Photoelectron  yield  for  normally 
incident  sunlight 

14 

ohms  square-* 

Surface  resistivity  (=  -1  for 
non-conducting  surface) 

15 

Vol  ts 

Maximum  (absolute)  potential 
attainable  before  a discharge  must 
occur 

16 

Vol  ts 

Maximum  potential  difference 
between  surface  and  underlying 
conductor  before  a discharge  must 
occur 

17 

ohms-!  m“! 
(m2  s-3)-l 

Radiation-induced  conductivity 
coefficient  (k) 

18 

None 

Radiation-induced  conductivi ty 
power  (a) 

19 

kg  m-3 

Material  density 

100 


4.3.2 


THICKNESS  (PROPERTY  2) 


Property  2 gives  the  thickness  d of  a dielectric  film  covering 
an  underlying  conductor  in  meters,  d is  arbitrary  and  may  be  chosen 
to  be  more  or  less  than  a mesh  unit.  However,  note  that  NASCAP  uses 
thin-film  approximations  in  many  of  its  calculations  involving 
surfaces  (Section  4.8). 

4.3.3  BULK  CONDUCTIVITY  (PROPERTY  3) 

Property  3 cjives  the  bulk  conductivity  oQ  of  the  surface 
material  in  ohms-1  m-i.  a is  assumed  to  be  the  value  appropri- 
ate for  a sample  not  exposed  to  any  radiation  and  not  subject  to  any 
internal  electric  fields.  Field  enhancement  and  radiation  enhancement 
of  aQ  is  taken  into  account  by  NASCAP  internally  (if  these  effects 
are  selected  as  run  options  (6.3.6  and  6.3.9)).  A value  of  -1 
indicates  that  the  material  is  a metallic  conductor. 

4.3.4  ATOMIC  NUMBER  (PROPERTY  4) 

Property  4 is  the  atomic  number  for  pure  elements  or  the  mean 
atomic  number  for  chemical  compounds;  e.g.,  polyethylene  (CHg) 
has  a mean  atomic  number  of  (6  + 1 + l)/3  = 2.7. 

4.3.5  SECONDARY  YIELD  (PROPERTIES  5 AND  6) 

Properties  5 and  6 are  the  coordinates  of  the  maximum  in  the 
secondary  electron  yield  curve  of  the  material.  The  secondary  yield 
curve  is  a plot  of  secondary  yield  <s 


current  of  secondary  electrons  emitted 
incident  primary  electron  current 


for  normally  incident  electrons,  against  the  incident  energy  of  the 
primary  electron  E.  This  is  shown  in  Figure  4.5.  Property  5 contains 

5max’  and  Pr0Pe^y  6 contains  Emax  in  keV. 
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4.3.6 


ELECTRON  RANGE  (PROPERTIES  7,  8,  9 AND  10) 


Part  of  the  secondary  electron  emission  formulation  requires  an 
analytical  form  for  the  "range"  of  electrons  in  the  material.  The 
range  is  the  depth  to  which  the  electrons  can  penetrate  the  material 
as  they  are  continuously  slowed  down  by  losing  energy  to  the  material 
lattice.  NASCAP  uses  a biexponential  form.  If  Pj,  Pg,  Pg,  and 
P^0  are  properties  7-10  respectively,  the  range  R is  given  by 

R = P7  E**8  + P9  E^10 


The  four  parameters  are  obtained  from  fits  to  stopping  power  data 

° -10 

(Section  4.8).  The  range  is  determined  in  A (10  m) . If  no 

reliable  stopping  power  data  or  four  parameter  fits  are  available,  the 
range  may  be  estimated  from  Feldman's  formula^  automatically  by 
assigning  -1  to  property  7.  In  this  mode  properties  7-10  are  assigned 
as  follows: 


P0  = null 


3 

Pg  = material  density  (g  cm  ) 

PlO  = mean  atomic  weight  (AMU) 

The  mean  atomic  weight  is  calculated  in  the  same  way  as  the  mean 
atomic  number  (4.3.4)  using  atomic  masses  rather  than  numbers. 

4.3.7  ION  INDUCED  SECONDARY  EMISSION  (PROPERTIES  11  AND  12) 

Secondary  emission  of  electrons  due  to  ion  impact  is  also 
treated  using  a two  parameter  theory  (Section  4.8).  Parameter  11 
contains  the  yield  for  1 keV  normally  incident  protons  and  parameter 
12  the  proton  energy  that  produces  the  maximum  electron  yield.  The 
secondary  emission  properties  due  to  impact  of  ions  other  than  protons 
are  assumed  to  be  identical  to  the  proton  values. 
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4.3.8 


PHOTOEMISSION  (PROPERTY  13) 


Property  13  contains  the  yield  of  photoelectrons  from  the 
surface  material  exposed  to  the  solar  spectrum.  The  intensity  is  that 
measured  on  earth  93,000,000  miles  from  the  sun.  (Earth  orbit 
altitudes  are  negligible  by  comparison  and  the  intensity  of  the  sun 
close  to  earth  may  be  considered  constant.) 

4.3.9  SURFACE  RESISTIVITY  (PROPERTY  14) 

Property  14  gives  the  intrinsic  surface  resistivity  in  the  "ohms 
per  square".  This  rather  odd  unit  is  used  to  distinguish  the 
resistivity  coefficient  (property  14)  from  the  actual  surface 
resistance  (in  ohms)  calculated  by  NASCAP.  Consider  two  points  in  a 
plane  A and  B,  a distance  Lj.  apart.  If  L2  is  the  "width"  of  the 
plane 


surface  resistance  = surface  resistivity 


dimensionless 

i.e.  ohms  « (ohms  per  square)  x geometrical 

factor 


L2 

4 

A 

B 
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NASCAP  uses  the  surface  resistivity  per  square,  times  a geometrical 
factor  it  calculates  to  determine  the  surface  resistance  between  two 
adjacent  materials. 

The  intrinsic  surface  conductivity  is  due  to  the  migration  of 
electrons  along  the  surface  layer  aided  by  adsorbed  impurities  and 
defects.  An  additional  contribution  is  made  by  photo  electrons 
"hopping"  along  the  surface.  This  so-called  "photosheath"  conduc- 
tivity is  included,  if  requested  using  the  run  option  'EFFCON  ON' 
(Section  6.3.4). 

Surface  conductivity  may  be  omitted  from  the  current 
calculations  completely  by  choosing  property  14  to  be  negative. 

4.3.10  DISCHARGE  ANALYSIS  (PROPERTIES  15,  160 

Properties  15  and  16  refer  to  discharges.  Property  15  contains 
the  maximum  absolute  potential  that  the  material  may  reach  (in  volts) 
before  a "blowoff"  of  charge  to  space  (or  tank  walls)  must  occur. 
Property  16  contains  the  maximum  potential  difference  (in  volts)  that 
can  exist  between  the  material  surface  and  an  underlying  conductor 
before  a "punchthrough"  or  dielectric  breakdown  must  occur. 

If  a discharge  analysis  is  requested,  upon  reaching  these 
limiting  potentials  NASCAP  redistributes  the  charge  in  an  appropriate 
way  (6.3.3). 

4.3.11  PROPERTIES  17,  18,  19,  20  (RADIATION  INDUCED  CONDUCTIVITY) 

These  four  properties  are  all  used  by  the  radiation-induced 
conductivity  option  (6.3.9  and  4.8).  The  extra  bulk  conductivity  due 
to  irradiation  of  the  sample  with  high  energy  electrons  a is  given 
by 

ar  = k DA 
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where  D is  the  dose  rate  (energy  deposited  per  unit  mass  per  second) 

to  the  material  from  the  high  energy  electrons.  Properties  17 

-1  -1  2 -3  -1  -1 

and  18  contain  k in  ohms  m (ms)  (lrad  s 

-2  2 3 

10  ms)  and  the  power  a,  respectively. 

_3 

Property  19  contains  the  density  of  the  material  in  kg  m and 
is  used  to  calculate  the  dose  rate  (4.8).  Property  20  is  used  by 
NASCAP  to  store  the  original  value  of  aQ  entered  by  the  user  as 
property  3.  Property  3 is  replaced  by  the  value  of  the  overall 
effective  bulk  conductivity,  including  field  and  radiation  enhancement. 
No  significant  user  input  is  required  for  property  20. 

4.4  DEFINING  MATERIALS 

New  materials  are  defined,  and  their  properties  assigned  inside 
the  object  definition  file  ISAT  (3.5).  The  object  definition  file  is 
read  by  NASCAP  module  OBJDEF.  OBJDEF  interprets  any  word  that  it  does 
not  recognize  as  a building  block  keyword  (or  their  parameter  cards 
(3.9.6))  as  the  definition  of  a new  material  name.  New  material  names 
may  not  appear  inside  building  block  definitions  (i.e.,  between  a 
building  block  keyword  and  an  'ENDOBJ*  statement). 

Following  the  material  name  OBJDEF  expects  to  find  three 
additional  cards  specifying  20  constants  as  the  material  properties  to 
be  associated  with  the  name.  The  20  constants  correspond  to  properties 
1-20  and  are  read  sequentially;  i.e.,  the  first  constant  read  is  inter- 
preted as  property  1,  the  second,  property  2,  and  so  on.  They  are 
arranged  sequentially,  eight  per  card,  so  that  cards  1 and  2 each  have 
eight  numbers  and  card  3,  four  numbers.  Formally  each  number  is 
written  in  a field  of  up  to  ten  characters,  but  NASCAP  will  read  the 
cards  in  free  format.  No  units  need  be  specified.  NASCAP  will  assume 
the  units  given  in  Table  4.1  and  no  others.  For  properties  not 
requiring  any  input  such  as  property  20,  or  properties  17-19  for 
conductors,  some  constant  must  be  entered  but  its  value  is  arbitrary. 
(NASCAP  will  not  actually  use  the  values  entered  but  expects  to  read 
something. ) 
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Once  the  three  material  property  cards  have  been  read  OBJDEF  is 
ready  to  accept  any  other  keywords  or  more  material  names.  NASCAP 
will  recognize  up  to  fifteen  different  materials. 

Materials  roust  be  defined  before  they  are  referred  to  in  any 
building  block  definition.  For  example,  if  I assign  the  surface  of  a 
sphere  to  be  'FSTUFF'  with  the  card 

MATERIAL  FSTUFF 

if  'FSTUFF'  and  its  material  properties  have  not  been  declared  earlier 
in  the  object  definition  file,  an  error  will  occur  and  execution  will 
stop.  For  this  reason  all  the  materials  to  be  used  are  usually 
declared  at  the  very  beginning  of  the  object  definition  file.  This  is 
shown  in  Figure  4.1. 

4.5  DEFAULT  MATERIALS 

There  is  one  case  where  the  user  can  forget  to  define  his  or  her 
materials  and  get  away  with  it.  When  OBJDEF  encounters  a material 
that  hasn't  been  defined  already,  before  an  error  occurs,  it  checks 
the  following  list  of  default  materials: 

ALUM IN 

AQUADG 

CPAINT 

GOLD 

INDOX 

MAGNES 

SCREEN 

KAPTON 

NPAINT 

SI02 

SOLAR 

TEFLON 

SILVER 
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COMMENT  DEFINITION  OF  SATELLITE  “BIG  EARS" 


Material  Name  1 
(3  material  property  cards 

Material  Name  2 
{3  material  property  cards 

COMMENT  DEFINE  MAIN  BODY 

CONDUCTOR  1 

QSPHERE 

{parameter  cards 
ENDOBJ 

RECTAN 

{parameter  cards 
ENDOBJ 

• 

. more  building  blocks 
• 

COMMENT  DEFINE  SOLAR  PANEL  (SEPARATE  CONDUCTOR) 

CONDUCTOR  2 

PLATE 

{parameter  cards 
ENDOBJ 

• 

. more  building  blocks 

COMMENT 

CONDUCTOR  3 
« 

more  conductor  segments 

ENDSAT 

Figure  4.1.  General  form  of  the  object  definition  file  ISAT. 


If  the  material  is  included  in  this  list,  it  becomes  one  of  the  up  to 
fifteen  defined  materials  and  its  properties,  stored  internally,  are 
automatically  entered  as  OBJDEF  input  by  the  code.  The  properties  of 
these  materials  are  shown  in  Table  4.2.  Any  further  reference  to  the 
material  will  assign  the  same  set  of  properties  to  the  surfaces 
concerned.  If  the  material  is  not  found  in  this  list,  an  error  will 
occur. 


If  two  sets  of  material  properties  are  defined  with  the  same 
name,  or  names  with  the  same  first  four  letters,  two  of  the  fifteen 
possible  materials  are  used  up  but  only  the  first  set  of  material 
properties  are  used.  For  example,  if  GOLD  is  referenced  before  it  is 
defined  in  the  runstream,  the  default  material  properties  of  gold  will 
be  associated  with  _aV[  gold  surfaces  in  the  object  definition  file. 

If  a material  called  'GOLD'  or  'GOLDPD'  or  'GOLDXXXX'  is  defined  later 
with  different  properties  the  number  of  materials  NASCAP  thinks  it  has 
will  be  increased  by  one,  but  the  new  properties  will  be  effectively 
ignored.  Multiple  definition  of  materials  should  be  avoided.  Note, 
however,  that  if  any  of  the  default  materials  are  explicitly  defined 
before  they  are  referred  to  in  building  block  definitions  then  NASCAP 
will  make  no  attempt  to  find  them  in  the  list  of  default  materials  and 
the  materials  will  not  be  multiple  defined. 

4.6  THE  OBJECT  DEFINITION  FILE  - ANOTHER  EXAMPLE 

We  are  now  ready  to  bring  together  Chapters  3 and  4 and  examine 
the  structure  of  the  object  definition  file  ISAT.  The  general  form  is 
shown  in  Figure  4.1.  The  materials  are  defined  first,  followed  by  the 
building  blocks  associated  with  each  separate  conductor.  The  use  of 
COMMENT  cards  allow  the  logic  of  the  definition  of  a complex  object  to 
be  followed  more  easily.  Finally  the  whole  file  is  terminated  with  an 
'ENDSAT'  statement.  An  actual  example  is  shown  in  Figure  4.2.  This 
object  is  the  same  as  the  one  used  in  the  worked  example  described  in 
Chapter  11.  It  consists  of  a central  RECTANgular  body  connected  to 
two  QSPHERES  via  two  short  BOOMS. 
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A 3D- VIEW  (6.6.1)  of  the  object  produced  by  NASCAP  is  shown  in 
Figure  4.3.  A more  detailed  discussion  of  the  definition  of  this 
object  is  given  in  Section  11.2. 

4.7  OBJECTS  WITHIN  OBJECTS:  VARIEGATED  SURFACES 

NASCAP  makes  it  easy  to  define  surfaces  that  are  made  up  of  more 
than  one  material.  For  example,  we  may  want  to  define  one  face  of  a 
cube  to  be  mainly  KAPTON  but  with  a patch  of  say  GOLD  in  the  center 
(Figure  4.4).  We  begin  by  defining  the  cube  with  a KAPTON  face.  The 
center  surface  cell  is  then  replaced  with  GOLD  by  defining  a second 
smaller  cube  inside  the  first  cube.  The  second  cube  is  defined  so 
that  one  of  its  faces  is  coincident  with  the  KAPTON  face.  The  surface 
common  to  both  cubes  is  then  associated  with  the  material  on  the  face 
of  the  second  cube,  which  in  this  case  is  GOLD.  This  is  shown  in 
Figure  4.4. 

The  object  definition  file  associated  with  this  object  has  the 

form: 


COWENT 

VARIEGATED 

RECTAN 

CORNER 

-2 

-2  -2 

DELTAS 

3 

3 3 

SURFACE 

+x 

KAPTON 

SURFACE 

-X 

KAPTON 

SURFACE 

+y 

KAPTON 

SURFACE 

-y 

KAPTON 

SURFACE 

+z 

KAPTON 

SURFACE 

-z 

KAPTON 

ENDOBJ 

RECTAN 

-1 

-1  -1 

CORNER 

DELTA 

1 

1 1 

SURFACE 

-z 

GOLD 

ENDOBJ 

ENDSAT 
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Figure  4.3.  3D-VIEW  of  object  produced  by  SATPLT  (hidden  lines). 


The  same  principle  can  be  applied  to  any  of  the  building 
blocks.  Exposed  surface  cells  common  to  two  or  more  building  blocks 
are  assigned  to  the  material  of  the  most  recently  defined  block. 

Two  special  building  blocks  are  supplied  specifically  to  create 
variegated  surfaces.  PATCHR  and  PATCHW  define  a RECTAN  (cuboid)  and  a 
WEDGE  respectively,  that  may  be  used  to  "patch"  other  objects  without 
adding  to  NASCAP's  list  of  filled  space.  The  use  of  actual  RECTAN  and 
WEDGE  blocks  inside  others  is  also  perfectly  legitimate,  but  adds  to 
the  internally  used  list.  If  the  list  becomes  too  long  (as  it  might 
for  a complicated  object)  shadowing  calculations  are  no  longer 
possible  (8.1).  The  use  of  PATCHR  and  PATCHW  reduce  the  likelihood  of 
this  problem  occurring. 

The  object  shown  in  Figure  4.4  could  also  be  defined  using 
PATCHR: 


COMMENT  VARIEGATED  CUBE  (PATCHR) 
RECTAN 

CORNER  -2  -2  -2 

DELTAS  333 

SURFACE  +X  KAPTON 

SURFACE  -X  KAPTON 

SURFACE  +Y  KAPTON 

SURFACE  -Y  KAPTON 

SURFACE  +Z  KAPTON 

SURFACE  -Z  KAPTON 

ENDOBJ 
PATCHR 

CORNER  -1  -1  -1 

DELTAS  1 1 1 

SURFACE  -Z  GOLD 

ENDOBJ 
ENDSAT 
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4.8  TECHNICAL  DISCUSSION 


4.8.1  SECONDARY  ELECTRON  EMISSION  DUE  TO  ELECTRON  IMPACT 

Secondary  electrons  are  defined  as  those  emitted  from  the 
surface  due  to  particle  impact  with  energies  below  50  eV.  Their 
energy  distribution  is  usually  peaked  below  10  eV.  We  define  the 
secondary  yield  a as  the  ratio  of  primary  to  secondary  electron 
current. 


emitted  secondary  current  due  to  electron  impact 
primary  electron  current 


NASCAP  calculates  the  secondary  electron  emission  yield,  a, 

[2] 

using  the  empirical  formula: 


R 

s(e)  = C J 
0 


dE 

■ax 


-ax  cose  . 
e dx 


where  x is  the  path  length  of  penetration  of  a primary  electron  beam 
into  the  material,  R is  the  “Range",  or  maximum  penetration  length, 
and  e is  the  angle  of  incidence  of  the  primary  electron. 

[5i 

This  equation  is  based  upon  a simple  physical  model: 

a.  The  number  of  secondary  electrons  produced  by  the  primary 
beam  at  a distance  x is  proportional  to  the  energy  loss  of 
the  beam  or  "stopping  power"  of  the  material,  IdE/dxl. 

b.  The  fraction  of  the  secondaries  that  migrate  to  the  surface 
and  escape  decreases  exponentially  with  depth 

GtX  COS0 

(f  = e ).  Thus  only  those  produced  within  a few 

multiples  of  the  distance  1/a  (the  depth  of  escape)  from 
the  surface  contribute  significantly  to  the  observed  yield. 
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The  range  increases  with  the  initial  energy,  EQ,  of  the 
incident  electrons  in  a way  that  approximates  a simple  "power 
law":^ 


R 


= b E 


n 

o 


where  1.0  < n < 2.0. 

This  equation  implies  a simple  form  for  the  stopping  power  S(E): 


S(E)  = 


dE 

dR 

lx 

-1 


Because  the  primary  beam  loses  energy  as  it  passes  through  the 
material,  both  E,  and  hence  S(E0>x),  depend  on  the  path  length  x. 
Integrating: 


En(x)  = E 


n x 
o " F 


S(x) 


1-1/n 


The  stopping  power  S(EQ,x)  depends  upon  both  the  initial  electron 
energy  EQ,  via  R,  and  the  path  length  x.  Figure  4.5a  shows 
schematically  S(EQ,x)  plotted  against  x for  several  values  of  Eq. 
Inspection  of  Figure  4.5a  and  the  equation  for  S(x)  illustrates  the 
following  points: 

1.  S(Eq,x)  increases  with  x,  slowly  at  first,  before 
reaching  a singularity  as  x approaches  R. 

2.  The  initial  value  of  S(EQ,x)  decreases  with  increasing 
initial  energy  EQ. 

Both  of  these  observations  are  due  to  the  decrease  in  electron-atom 
collision  cross-section  with  increasing  energy. 
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Power  Law 
E-Dependence 

Linearized 
E- Dependence 


The  yield  Is  only  sensitive  to  the  details  of  the  stopping-power 
depth-dependence  for  initial  energies  with  ranges  of  the  same  order  as 
the  escape  depth,  R ^ 1/a  (i.e.,  about  the  maximum  of  the  yield 
curve).  For  lower  energies,  R « 1/a,  and  essentially  all  of  the 
primary  energy  is  available  for  detectable  secondary  production, 
leading  to  a linear  increase  in  yield  with  increasing  EQ.  At  higher 
energies,  where  R » 1/a,  S(EQ,x)  remains  almost  constant,  at  its 
initial  value,  over  the  depth  of  escape  and  so,  along  with  S(EQ,x) 
the  yield  decreases  as  EQ  increases. 

NASCAP  takes  this  into  account  and  approximates  the  stopping 
power  by  a linear  expansion  in  x,  about  x = 0. 


dE  | 

f dR  ' 

l +7d2R\ 

/dR  \ 

3x  "1 

1 ‘if/ 

w 

NASCAP  allows  for  a bi -exponential  range  law: 

nl  n2 

R * bl  Eo  + b2  Eo 


involving  four  parameters  b^,  b^,  n^,  n^.  The  parameters  are 

fit  to  reproduce  range  data  as  accurately  as  possible.  For  materials 

where  no  suitable  data  is  available,  a mono-exponential  form  is 

[4] 

generated  using  Feldman  s empirical  relationships,  connecting  b 
and  n to  atomic  data. 

b = 250  A/PZn/2 

n = 1 . 2/ ( 1 - 0.29  log1QZ) 

where  A is  the  atomic  or  molecular  weight  of  the  material,  Z is  the 
atomic  number,  and  p is  the  density.  The  stopping  power  is  then 
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obtained  indirectly  via  the  equation  above.  Recently  good  theoretical 
estimates  of  the  stopping  power  for  a number  of  materials  have  become 
available.  Comparison  of  these  values  with  those  implied  by  the 
range  data  showed  significant  discrepancies,  particularly  for  those 
materials  fit  using  Feldman's  formula.^"  ^ A better  approach  is  to 
fit  the  four  parameters  in  the  equation  for  R directly  to  the  stopping 
power  data. 


■ ("i*/1 


-1 


n^E 


n2- 


■) 


-1 


4.8.2  SECONDARY  EMISSION  DUE  TO  ION  IMPACT 


Secondary  emission  of  electrons  due  to  ion  impact  is  treated 
in  a way  similar  to  that  for  electron  impact  discussed  in  4.9.1. 
The  yield  a is  given  by 


t 

A(e)  = C 

0 


dE 

cfx 


e”oX  sine  dx 


The  angular  dependence  is  assumed  to  be  a simple  sine  form,  and  the 
stopping  power  is  assumed  to  be  independent  of  path  length  x over  the 
thickness  t of  the  sample. 


dE 

lx 


6 E1/2/(l  ♦ E/Emx) 


Emax  is  the  energy  at  the  maximum  in  the  yield  curve.  This  is  ~50 
keV  for  most  materials.  A typical  yield  curve  is  shown  for  aluminum 
in  Figure  4.6. 
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1 keV  10  keV  0.1  MeV  1 MeV  10  MeV 

Incident  Energy 

Figure  4.6.  Secondary  emission  by  aluminum  for  proton  impact  at  normal  incidence;  experimental  points 
as  Indicated. 


4.8.3 


BACKSCATTER 


Backscattered  electrons  are  those  emitted  from  the  surface  with 
energies  above  50  eV.  Their  energy  distribution  is  usually  peaked 
close  to  the  primary  incident  energy  and  they  may  be  considered  as 
reflected  electrons. 

The  large-angle  scattering  theory,  together  with  Monte  Carlo 
data  and  experiments  by  Darlington  and  Cosslett,^^  indicate  that 
the  angular  dependence  of  backscattering  is  well  described  by 

n(«)  = n(0)  expEnjU  - cose)] 

where  the  value  of  1S»  within  the  uncertainty  in  the  data,  what 
would  be  obtained  by  assuming  total  backscattering  at  glancing 
incidence,  viz.  * -log  n • The  net  albedo  for  an  isotropic 
flux  is  then 

\ 

A0  - 2[1  - n„(l  - log  n0) ]/ ( log  %)2  . 


As  the  energy  is  decreased  below  10  keV  the  backscattering 
increases.  Data  cited  by  Shimizu^*^  indicate  an  increase  of  about 
0.1,  almost  independent  of  Z.  NASCAP  approximates  this  component  of 
backscattering  by 


5n0  = 0.1  exp[-E/5  keV]  . 


At  very  low  energies  the  backscattering  coefficient  becomes  very  small 
and,  below  50  eV,  backscattering  and  secondary  emission  are 
indistinguishable.  NASCAP  takes  account  of  this  by  a factor  of 
[(E  - 50  eV)/log  20]  log(E/50  eV). 

The  formula  for  energy-dependent  backscattering,  incorporating  these 
assumptions,  is  then 
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n0  = { [log(E/0.05)©(E  - 0.05)0(1.0  - E)/log(20) 

+ 0(E  - 1.0)}  x [0.1  exp(-E/5)  + 1 - (2/e)*0372] 


where  energies  are  measured  in  keV. 
4.8.4  PHOTOEMISSION 


The  user  enters  the  yield  (Y),  or  number  of  electrons  emitted 
for  a surface  normally  exposed  to  the  solar  spectrum,  an  “earth 
distance"  from  the  sun.  NASCAP  calculates  the  photocurrent  from  a 
surface  exposed  to  the  sun  at  an  angle  e,  according  to  the  formula 


^phot 


= (Area  exposed)  *Y  »cose 


This  assumes  that  the  yield  per  photon  is,  on  average,  independent  of 
e. 


4.8.5  CONDUCTIVITY 

The  bulk  conductivity  « is  assumed  constant  unless  the 

o 

‘RADC0N1  and  'FLDCON'  options  are  chosen  to  be  'ON'  (6.3.6  and 
6.3.9).  With  these  options  in  force  a is  enhanced  by  both  fields 
across  the  dielectric  film  and  high  energy  electron  fluxes. 

a.  FIELD-INDUCED  CONDUCTIVITY 

Consider  a thin  dielectric  film  of  thickness  d covering  an 
underlying  conductor.  If  the  potential  of  the  dielectric  surface  V$ 
differs  from  the  potential .of  the  conductor  V£,  current  will  flow 
due  to  bulk  conductivity. 

Ic  . .04V  . -o(vs  - vc) 
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a is  the  bulk  conductivity  of  the  sample  in  mhos.  If  a is  the 
specific  conductivity  In  mhos  m"1  and  A is  the  area  of  the  sample  in 


a 


_ oA 

■ T 


i .e. 


ctA.aV 

3 


Ic  depends  on  aV  in  a nonlinear  way  due  to  the  electric  field 
enhancement  of  a.  Assuming  a thin  film,  the  field  E is  given  by 


[131 

Adamec  and  Calderwood  have  shown  that  a depends  on  E in  the 
following  way: 


a(E) 


2 + cosh 


where 


■F  - (^r) 


1/2 


and  q is  the  charge  on  the  electron  and  e is  the  dielectric  constant. 


b.  RADIATION -INDUCED  CONDUCTIVITY 


Dielectric  materials  have  characteristically  small  bulk 
conductivities  due  to  their  electron  band  structure.  Unlike  metals, 
the  delocalized  conduction  bands  are  empty  at  normal  temperatures  and 
electrons  are  strongly  localized  in  the  regions  close  to  individual 
nuclei.  However,  under  the  influence  of  an  exciting  source 
non-conducting  electrons  can  be  promoted  into  the  conduction  bands. 
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leading  to  an  increase  in  the  bulk  conductivity.  High  energy 
electrons  passing  through  the  dielectric  provide  such  an  excitation 
source . 

While  NASCAP  treats  the  non-penetrating  (£50  keV)  portion  of  the 
plasma  spectrum  explicitly  in  calculating  the  buildup  of  surface 
charge,  it  presently  neglects  the  very  low  fluxes  of  higher  energy 
penetrating  electrons,  since  they  make  a negligible  contribution  to 
the  total  incident  charge.  Recent  studies^  suggest,  however, 
that  the  penetrating  fluxes  may  influence  the  degree  of  differential 
charging  by  increasing  the  bulk  conductivity  in  this  way.  This 
enhancement  due  to  high  energy  electron  fluxes  is  described  as  the 
"radiation-induced"  conductivity  ar« 

[15] 

Frederickson  has  expressed  ar  in  terms  of  the  dose  rate 
D and  two  parameters  k and  a. 

a = kDA 
r 

k and  a are  characteristic  of  each  material  and  a usually  lies  between 
0.5  and  1.0.  The  dose  rate  can  be  estimated  from  the  stopping  power  S 
for  electrons  in  the  medium  of  interest. 

S(E)  = dE/dx 

The  dose  rate  is  measured  as  energy  deposited  per  unit  mass  per  second 
(i.e.,  rad  s = 100  erg  g * s *).  Stopping  power  is  measured 
as  energy  deposited  per  particle  per  unit  thickness  of  the  sample. 
Dividing  S(E)  by  the  density  p of  the  sample  gives  the  energy 
deposited  per  particle  per  unit  mass  of  the  material  multiplied  by 
unit  area.  The  product  of  this  quantity  with  the  flux  (particles  per 
unit  area  per  second)  gives  the  required  dose  rate: 

. S(E) 


D = flux 


p 


The  flux  of  incident  electrons  due  to  a plasma  with  distribution 
function  f(E)  is  given  by: 

<nf>  = ^ fz  f (E)  dE 
nr  J 

6 = [e  f (E)  SCE)  dE 
pm r J 


A number  of  models  for  the  energy  spectrum  of  high  energy  fluxes 
in  space  have  been  measured. All  show  a Maxwellian  like 
behavior,  i.e.. 


f 171  2 -3 

The  AE3  model  implies  a value  of  3 x 10  m for  the  density 
2 

N and  2.5  x 10  keV  for  the  temperature  T at  geosynchronous  orbit. 

Electrons  in  this  energy  range  are  relativistic;  i.e.,  their  velocity 

is  close  to  that  of  light  (c)  and  so  the  weight  function  E in  the 

2 

integral  above  should  be  replaced  by  me  . This  is  confirmed  by  a 
plot  of  <nf>  against  E which  shows  the  same  exponential  behavior. 

50 

(where  we  assumed  the  contribution  from  non-penetrating  electrons  with 
energies  below  50  keV  is  negligible). 

The  dose  rate  is  calculated  in  NASCAP  for  each  material  by 

integrating  the  above  equation,  using  Simpson's  rule,  between  50  keV 

°-l 

and  4 T.  If  all  energies  are  in  keV  and  S(E)  is  in  keV  A and  I is 
the  value  of  the  integral: 


124 


2 -1 

• I kev  A 1 


Substituting: 


• 3 N • T 2 -3 

D = 1.38  x lCT  nr  s 0 


-3  -3 

where  N is  in  units  of  m , p (kg  m ) and  T is  in  keV. 

ns! 

Frederickson  has  pointed  out  that  k is  often  known  to 

within  only  2 orders  of  magnitude  and  a values  are  usually  close  to 

-17  -1  -1  -1 

1.  We  assume  values  of  k = 1 x 10  mhos  cm  (rad  s ) 

-13  -1  2 -3  -1 

= 1 x 10  mhos  m (ms)  and  a = 1 as  default 
material  properties  17  and  18,  respectively.  The  density  p in 

_3 

kg  m is  material  property  19.  Since  the  density  of  plastics  and 

other  insulators  depends  very  much  on  the  particular  sample  and 

3 -3 

manufacturer,  default  values  are  chosen  to  be  1 x 10  kg  m . 

4.8.6  ATTENUATION  OF  INCIDENT  CURRENT 

The  net  incident  particle  flux  is  attenuated  as  the  surface 
becomes  charged  (either  positively  or  negatively).  This  is  because 
the  flux  of  particles  with  opposite  sign  to  the  surface  potential  is 
enhanced  and  the  flux  of  particles  with  the  same  sign  is  decreased. 
NASCAP  assumes  a spherical  orbit  limited  particle  collection  formula. 
This  is  a good  approximation  for  convex  objects  with  radius  of 
curvatures  smaller  than  the  Debye  length  of  the  ancient  plasma.  This 
is  the  major  restriction  that  confines  NASCAP  to  charging  problems  in 
the  geosynchronous  (long  Debye  length)  regime.  Spherical  orbit 
limited  collection  gives  the  following  form  for  the  variation  of 
incident  current  I with  surface  potential  V: 
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J(E)  =J0  (.  + «)  (l-^y) 


where  E is  the  kinetic  energy  of  the  repelled  particle  at  the  surface, 
q is  the  sign  of  the  charge  on  the  particle,  and  E+qV  is  the 
particle's  total  energy.  The  same  formula  holds  for  attracted 
particles. 
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TABLE  4.2.  MATERIAL  PROPERTIES 


MATERIAL  1 : ALUM 


PROPERTY  INPUT  VALUE  ccde  value 


1 

DIELECTRIC  CONSTANT 

1 « u 0 *030 

(NONE) 

1 .00*000 

(NONE  > 

2 

thickness 

i.cc-oa: 

METERS 

1.00-002 

MESH 

3 

conductivity 

-1 .Cr*COQ 

MHC/M 

-l.CO*COO 

mho/m 

4 

ATONIC  NUHBES 

1. 30*001 

(NONE) 

1.30*001 

(NONE) 

5 

DELTA  HA X >COEFF 

9 •70-031 

(NONE) 

9.18*000 

(NONE) 

6 

E-HAX  >0EPTh*.-1 

3 • 00*00 1 

KEV 

3.00-002 

ANG-C1 

7 

range 

1.54*002 

ANG. 

1.23*002 

ANG. 

8 

EXPONENT  > RANGE 

8.00-001 

(NONE) 

3 . 37*002 

ANG. 

9 

RAN6E  > EXPONENT 

2.20*002 

ANG  . 

o .CO-OC 1 

(NONE) 

10 

EXPONENT 

1.76*000 

(NONE  > 

1 • 76*0CC 

(NONE  1 

11 

YIElO  FOR  IHEV  protons 

2.4“-C01 

(NONE ) 

2.44-001 

(NONE ) 

12 

H a X DE/OX  FOR  PROTONS 

2.30*03 2 

KE  V 

2#.  33*032 

KEV 

13 

PMOTOCURPENT 

4 .cc-cos 

A/M**2 

4 . 3Q-CG5 

A/m**2 

14 

SURFACE  RESISTIVITY 

— l.J0*3CC 

OHMS 

-S. 35-013 

v-s/c 

15 

SPACE  0ISCHAR3E  POT’L 

i.0C*C34 

VOLTS 

1 . wG*uC  4 

VOLTS 

16 

INTERNAL  DISCHAftGEPOT'L 

2 • 30*032 

VOLTS 

2.30*033 

VOLTS 

17 

RAON  INOUCEDCONq’YCOEFFT 

1 *00-013 

MHCMS3 

1. 30-013 

MH0MS3 

18 

RAOn  INOUCEOCONG’YPOnER 

i.C0*333 

(NONE) 

l.CO*OQC 

t NONE ) 

19 

20 

DENSITY 

1.00*003 

2.00*001 

KG/M*i 

1.00*003 

-1.00*000 

KG/M*3 

MATERIAL  2:  ACUA 

property 

1 01 ELEC  TP IC  CONSTANT 

2 thickness 

I CONDUCTIVITY 

4 ATOMIC  NUMBER 

5 DELTA  max  >COEFF 

6 E-max  >oepth**-i 

7 RANGE 

8 EXPONENT  > Range 

9 RANGE  > EXPONENT 

10  EXPONENT 

11  YIELD  FOR  Ik  ev  ppotons 

12  MAX  OE/OX  FOR  PROTONS 

13  PHOTCCUR°ENT 

la  SURFACE  RESISTIVITY 

15  SPACE  DISCHARGE  POT*L 

16  INTERNAL  DISCHAPGEPOT’L 

1?  RAON  INDUCEOCONO*YCOEFFT 

18  RADN  INDUCEOCONG'YPOacP 

19  DENSITY 

20 


INPUT  VALUE 

CCDE  VALUE 

1.20*000 

(NONE ) 

1.30*030 

(NONE) 

I.3C-C33 

meters 

1.3C-CQ2 

-ESH 

i. :c*ccc 

*HC/M 

-1.33 ♦CCC 

MHC/“ 

6.00*000 

(NCnE) 

o. 30*000 

(NCNE) 

1 .00*030 

(NONE) 

7 .36*030 

(NONE) 

3 .30-031 

KEV 

2. 21-032 

ANG-C1 

>1.30*030 

ANG. 

5 .33*032 

ANG  • 

.30 

(NONE) 

.30 

A\G  • 

2.30*030 

ANG. 

1.55*030 

( NONE ) 

1.23*001 

(NONE ) 

1.30*030 

(NONE) 

4.55-031 

(NONE ) 

4.55-001 

(NONE) 

1.40*032 

KEV 

1.40*032 

KEV 

2.13-335 

A/m**2 

2.10*005 

A/«**2 

>1.30*030 

OHMS 

-9.65-013 

V-S/C 

1.33*0 J4 

VOLTS 

1.30*03“ 

VOLTS 

2 • 30  *C3  2 

VOLTS 

2.30*03 2 

VOLTS 

1.0C-C13 

MHCMS3 

1 . GC-C1 5 

*HOMSi 

L * 03  *C 3C 

(NONE  > 

1 • w0*020 

(NONE) 

1.30*003 

KG/MMJ 

1 • 3u  *03  3 

kG/m*3 

2.3C*C 31 

-1.33*0UC 
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TABLE  4.2.  MATERIAL  PROPERTIES  (Continued) 


-ATERIAL  3:  CPA  I 

PROPERTY 

1 DIELECTRIC  CONSTANT  _ 

z thickness 

3 CONDUCTIVITY 

9 ATOMIC  NUMBER 

5 OELTA  max  >COEFF 

6 E-MAX  >OEPTHm-1 

7 Range 

a Exponent  > Range 

9 RAN6E  > EXPONENT 

io  exponent 

n yield  for  ikev  protons 

12  MAX  OE/OX  FOR  PROTONS 

13  PHOTOCURRENT 

19  SURFACE  RESISTIVITY 

15  SPACE  OISCHAPGE  POT»L 

16  INTERNAL  0 ISCHARGEPOT'L 

17  RAON  INOLCEOCONO  * YCOEFFT 

18  RAON  INOUCEDCONO #YPOtoER 

19  DENSITY 

20 


MATERIAL  4:  GOLD 

PROPERTY 

X OIELECTRIC  CONSTANT 

2 thickness 

3 CONDUCTIVITY 

9 ATOMIC  NUMBER 

5 OELTA  MAX  >CGEFF 

6 E-max  >DEPTh**-I 

7 RANGE 

8 exponent  > Range 

9 RANGE  > EXPONENT 

10  EXPONENT 

11  YIElD  FQP  ikev  PROTONS 

12  MAX  OE/OX  FOR  PROTONS 

13  PHOTOCURRENT 

19  SURFACE  RESISTIVITY 

15  SPACE  DISCHARGE  °OT*L 

16  INTERNAL  OISCHARGEPOT'L 

17  °A C N INOUCEDCONO* YCOEFFT 

18  PA  ON  INOUCEDCONO *YPO*cR 

19  DENSITY 

20 


INPUT  VALUE 


3 .50*000 

(NCNE) 

1*00-003 

METERS 

"1 .CO*GCC 

mhO/m 

5.00*000 

(NCNE) 

2.1C+C33 

(NCNE) 

1 .50-001 

KEV 

7.15*00 1 

ANG. 

b.cc-oai 

(NONE) 

3.12*0 32 

ANG. 

1.77*000 

(NCNE) 

9.55-001 

(NONE) 

1*90*002 

KEV 

2.00-005 

A/m**2 

-1. 00^000 

Ohms 

1 . 00  *CC9 

VOLTS 

2 . 30*C33 

VOLTS 

1.0C-013 

MHOMS  3 

1.30*030 

(NCNE) 

1.0C*C03 

kG/m*5 

2.33*001 

INPUT  VALUE 
1 « CC+C3C  (NONE  1 
1. 00-003  -ETERS 
-1*C0*0Q0  MHO/M 
7.90*001  (NONE ) 

а.  60-002  (NONE) 
S • CO— CO 1 k £ v 

б. 38+CS1  ANG. 
9.2C-CG1  (NONE) 
5.35*  C’Jl  ANS. 

1 . 73  *CQC  INONE) 
4.13-CC1  (NONE) 
i. 35*0Q2  K£v 
2.9C-CCS  A/***2 
-I.OC+CCC  OHMS 
1.23*039  VOLTS 
2.32*033  VOLTS 
i. CD-013  mhOMSJ 
i *3C  *OQC  (NONE) 
1.30*032  KG/M ml 
2.30*031 


COOE  VALUE 


3.S0*00C 

(NONE) 

1.C0-C02 

MESH 

*1 • u 3 *030 

MHO/M 

5.00*003 

(NONE) 

‘►♦36*001 

(NONE) 

a. 74-032 

ANG -Cl 

4. 29*001 

ANG. 

5.52*002 

ANG. 

6.00-001 

(NONE) 

1.77*000 

(NONE) 

4.55*001 

(NONE ) 

1 .40*002 

KEV 

2.00-005 

A/M«*2 

-a.as-013 

v-s/o 

1.00*004 

VOLTS 

2.30*003 

VOLTS 

1.30-Ci_3 

MM0MS2 

1 . 30  *00  0 

( NONE) 

1.30*033 

*$/M*3 

-1.33*000 

CODE  VALUE 
1 *03*000  (NONE) 

1*00-002  mesh 

-1. 30*000  MHC/M 
7.90*001  (NONE) 
2*93*000  (NONE) 
2.02-002  ANG-C1 
6.17*001  ANG. 
9.25*001  «NG. 
9.20-001  ( NONE) 
1.73*000  (NONE) 
4.13-231  (NCNE) 
1.35*002  KEV 
2.9C-0C5  A /«**2 
-6.6S-C12  V-S/C 
1.00*004  VOLTS 
2.20*003  VOLTS 
i.CC-CU  MH0MS3 
1.02*00 C (NONE) 
1.0C*C03  KG/M*3 
— i .03*000 


128 


TABLE  4.2.  MATERIAL  PROPERTIES  (Continued). 

-aTERIAL  5:  INOO 


PROPERTY  IHPUT  TfALUE  COOE  VALuE 


1 

DIELECTRIC  CONSTANT 

1 .30*033 

(NONE  ) 

1 'n  r>  * p n 
1 • w a-  * U VJ  w 

(NONE) 

2 

thickness 

1.GG-0C3 

HETE9S 

1 *33-032 

*ESh 

3 

conductivity 

-i.qo*ogo 

HHO/H 

-1.33+CGC 

«HO/m 

4 

ATOMIC  NUMBER 

2 • 44 ♦CO  1 

(NCnE) 

2*44 ♦cc 1 

(NONE ) 

5 

DELTA  -AX  >CO£FF 

i *40000 

(NONE ) 

3.32*030 

(NONE) 

6 

E--AX  >0EPTH**-1 

d *yu — G Q 1 

KE  V 

1*49-032 

A NG -Cl 

7 

range 

*1  • u *Q  D 0 

ANG* 

1.57*032 

ANG. 

a 

EXPONENT  >.  RANGE 

• 20 

(NCNE) 

• 33 

ANG. 

9 

RANGE  > EXPONENT 

7.18*020 

ANG* 

2.31*000 

(NONE) 

13 

EXPONENT 

5*55 *GG 1 

(NCNE) 

1.03*000 

(NONE) 

11 

YIELD  FOR  IkEV  PROTONS 

4.90-031 

(NONE ) 

4*90-031 

(NONE) 

12 

MAX  OE/OX  FOR  PROTONS 

1.23*032 

KEV 

1.23*032 

* E V 

13 

PHOTOCURRENT 

3.2C-CG5 

A/4#*2 

3 *23-035 

A/w**2 

19 

SURFACE  RESISTIVITY 

.uO*C2G 

OH*S 

-9.85-011 

V-S/3 

IS 

SPACE  DISCHARGE  POT’L 

1 • uO ♦034 

VOLTS 

1.30*034 

VOLTS 

16 

INTERNAL  QISCHArGEPOT’L 

2.30*003 

VOLTS 

2 . 30  *03  3 

VOLTS 

17 

RA ON  INOUCEOCOND’YCOEFFT 

1. 00-013 

MHC*S3 

i.aa-oi 3 

MH0MS3 

18 

RAON  INDUCEOCONO’YPOWER 

1.30*000 

(NONE) 

1.33*000 

(NONE) 

19 

20 

OENSITY 

MATERIAL  a:  “AGN 

1.00*003 

2.cc*ggi 

KG/N*3 

1.30*003 
— I.o3*000 

KG/M*3 

PROPERTY 

INPUT  VALUE 

COOE  V 4 

i LUE 

1 

DIELECTRIC  CONSTANT 

1 .30*023 

(NONE ) 

1. 133*030 

(NONE) 

2 

THICKNESS 

1.3C-C33 

NETEPS 

1 *30*002 

*ESh 

3 

conductivity 

-1 .30*030 

4HC/M 

—1*30 ♦COO 

*H0/* 

4 

ATOMIC  NUM 8t R 

i.20*C31 

(NG*E> 

1.32*031 

( N 0 (4  E ) 

5 

DELTA  MAX  >CCEFF 

9 .22-031 

(NONE ) 

7 • 32  *CUC 

( NONE ) 

6 

E-MAX  >OEPTH«*-i 

2. 53-021 

K£  V 

2*79-032 

ANG-01 

7 

range 

-i.ac*oaa 

ANG* 

6*96*032 

ANG. 

6 

Exponent  > range 

• 00 

(NONE) 

• 00 

ANG. 

9 

RANGE  > EXPONENT 

1 • 74<*>GC0 

ANG  • 

1.75*000 

(NONE) 

IQ 

EXPONENT 

2.43*031 

(NCNE) 

1.30*000 

(NON£ ) 

11 

yield  for  ikev  protons 

2*44-031 

(NCNE) 

2 *44-0q1 

(NONE) 

12 

MAX  OE/OX  FOR  PROTONS 

2.30*032 

K£V 

2.30*03 2 

KEV 

13 

PHOTOCURRENT 

4 *33-035 

A/*«2 

4 *30-035 

A/|4**2 

14 

SURFACE  RESISTIVITY 

-1*30*333 

CHHS 

-0.85-013 

V-S/C 

IS 

SPACE  DISCHARGE  POT’L 

• • u3  *Cu4 

VOLTS 

i .33*03  4 

VOLTS 

16 

INTERNAL  OISCHARGEPOT’L 

2.30*033 

VOLTS 

2*30 *CC 2 

VOLTS 

17 

RACN  INOUCEOCONO’YCCEFFT 

i*3C-3l3 

MHCHS3 

1.30-013 

*HOMS 2 

ia 

RAON  INOUCEDCONO ’ YPOnER 

;.CC*C33 

(NONE) 

1.20*030 

( NONE) 

19 

20 

density 

l.ac*033 
2 * 33 ♦CO  1 

KG/M*3 

1.33*023 

-1.30*000 

KG/M*i 
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TABLE  4.2 


MATERIAL  PROPERTIES  (Continued) 


«*Te»iAL  7:  sene 


PROPERTY 

INPUT  VALUE 

CC3E  VALUE 

1 

dielectric  constant 

:.30*c3c 

(NONE) 

1.00*030  (NCNE) 

2 

thickness 

1.CC-C33 

METERS 

1.20-022  me sh 

3 

conqucti vity 

-1.20*020 

MHO/M 

-i.ja*cco  mhc/- 

4 

atomic  NUMBER 

1.30*023 

CNOnF) 

i*J3*CQH  (NONE) 

S 

DELTA  MAX  >COEFF 

• sc 

(NONE) 

.37  (NONE) 

6 

E-«AX  >0EPTH«-1 

i.:c*G30 

KEV 

l.ia-oci  ang-o: 

7 

range 

1.30*001 

ANG. 

1 • 53  *0C 1 ANG. 

8 

exponent  > range 

1 .53*030 

(NONE ) 

•30  ANG. 

9 

RANGE  > EXPONENT 

.00 

ANG. 

1.50*030  (NONE) 

10 

Exponent 

i ®co*cao 

(NONE) 

1.00*030  (NONE) 

11 

yield  fqr  Ik ev  protons 

• DC 

(NONE) 

.00  (NONE) 

12 

MAX  Ot/OX  FOR  PROTONS 

1 • wQ ♦GCu 

KEV 

1.33 *C3C  K£V 

13 

photocurrent 

.30 

A/m**£ 

.30  A/"*»2 

14 

SURFACE  RESISTIVITY 

00*030 

Ohms 

-8.85-313  V-S/O 

15 

SPACE  DISCHARGE  pot*l 

1 •00*004 

VOLTS 

1.30*004  VOLTS 

16 

INTERNAL  dischargepot*l 

2.20*003 

VOLTS 

2.30*003  VOLTS 

17 

RACN  IND  UCEOCONO  * Y COEFF  T 

1 *00*013 

NHCMS3 

1 .30-013  MH0MS3 

13 

RAON  INOUCEDCONO*YPOH£R 

1 1 Cw^CwO 

(NONE) 

1 .3C*C3C  (NONE) 

19 

DENSITY 

1 *00*003 

KG/M*3 

1.30*033  KG/M*3 

20 

material  a:  kapt 

2.00*001 

-1.03*030 

PROPERTY 

INPUT  VALUE 

COOE  VALUE 

1 

DIELECTRIC  CONSTANT 

3.50*000 

(NONE) 

3.50*030  (NCNE) 

2 

thickness 

1. 27-004 

METERS 

1.27-003  MESH 

3 

CONDUCTIVITY 

1 *00*016 

MHO/M 

1.CC-C16  mhO/m 

4 

ATOMIC  NUMBER 

5.00*000 

( NOnE ) 

5.30*030  (NONE) 

5 

DELTA  -AX  >CO£FF 

2.10*030 

(NCNE) 

4.36*031  (NONE) 

6 

E-max  >QEPTmm-1 

1.5C-CG1 

K£V 

8.74-032  ANG-C1 

7 

range 

7.15*031 

ANG. 

4.29+C31  ANG. 

a 

EXPONENT  > Range 

6. 00-031 

(NCNE) 

5 .5  2 *032  ANG. 

9 

range  > EXPONENT 

3.12*032 

ANG  # 

6.00-3C1  (NONE) 

10 

EXPONENT 

1.77*.f7Qn 

(NCNE) 

1.77*033  1 NCN  £ ) 

11 

YIELD  FOR  IKEv  PROTONS 

4. 55-001 

(NONE  ) 

4*55-031  (NONE) 

12 

MAX  OE/DX  FOR  PROTONS 

1*4»].CC2 

K£v 

1.40*032  KEV 

13 

PHOTOCURPENT 

2 .33-035 

A/M**^ 

2.Jn-005  A/m**2 

14 

SURFACE  RESISTIVITY 

1.30*016 

OHMS 

8.85*033  V-S/G 

15 

SPACE  OISCHARGE  POT*L 

1.30*034 

VOLTS 

1.33*334  VOLTS 

16 

INTERNAL  0I$CHAR6EP0T*L 

2.00*033 

VOLTS 

2*30 *0C 3 VOLTS 

17 

PADN  INDUCECCONO’YCOEFFT 

1 .30*013 

MH0MS3 

1.03-013  MHOMSS 

18 

RAON  INOUCEDCONO *YPQ j£9 

1.0C*CC0 

(NONE) 

1.00*022  (NONE) 

19 

DENSITY 

1.30*003 

KG/M*3 

1.30*023  KG/M*3 

20 

2.30*001 

1.20-016 
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TABLE  4.2.  MATERIAL  PROPERTIES  (Continued). 

material  9:  *PAI 


PROPERTY 

INPUT  VALUE 

CODE  VALUE 

1 

OIELECTRIC  CONSTANT 

3 .50*000 

(NONE ) 

3. 52*302 

(NONE) 

2 

thickness 

3 •CC-C J5 

"ETERS 

5 .30-234 

MESH 

3 

conductivity 

5 • 9C-CI4 

mho/m 

5.9C-C14 

MHO/M 

4 

ATOMIC  NUMBER 

5.oo*ooc 

(NONE) 

5.30*000 

(NCNE) 

5 

OCLTA  MAX  >CO£FF 

2* 13*003 

< N CNE ) 

3.35*001 

1 NONE  ) 

6 

E-*AX  >OEPTh*«-L 

l.sc-oai 

KEV 

3.41-032 

AN6-C1 

7 

pange 

-i. jc*cog 

ang. 

1 .05 *003 

ANG. 

9 

EXPONENT  > RANGE 

(NONE) 

.33 

ANG  • 

9 

PANGE  > EXPONENT 

1.05*302 

ANG. 

:.si*coc 

(NONE) 

10 

EXPONENT 

9*3  3 ♦QCC 

(NONE  ) 

1.30*000 

(NONE) 

11 

YIELD  FOP  1K£V  PPOTONS 

4.5S-GGI 

(NONE) 

4.55-031 

(NONE ) 

12 

max  oe/ox  fop  protons 

1. 40^002 

KEV 

1.40*002 

KEV 

13 

PHOTOCUPPENT 

2.00-305 

A/*«2 

2.30-005 

A/«»*2 

SURFACE  RESISTIVITY 

1.20*013 

Ohms 

8.8S*D0C 

v-s/c 

15 

SPACE  DISCHARGE  POT*L 

1.0C+C04 

VOLTS 

1.00*034 

VOLTS 

16 

internal  DISChAPGEPOT’L 

2.00*003 

VOLTS 

2. 03*003 

VOLTS 

17 

9ADN  INOUCEDCONO*YCOEFFT 

1.00-0X3 

MH0MS3 

1 .30-01 2 

MH0MS3 

Id 

PAON  I NDUCEDCONO * YPOn£P 

1.00*000 

(NONE) 

1.03*QCC 

(NONE ) 

19 

DENSITY 

1.00*03 3 

KG/M*3 

1.32*003 

KG/M*2 

20 

MATERIAL  10:  SI02 

2.3C*0Cl 

5.9C-014 

PROPERTY 

INPUT  VALUE 

COOE  VALUE 

1 

DIELECTRIC  CONSTANT 

4 .:o*acc 

(NONE) 

4.03*23 C 

(NONE) 

2 

thickness 

1.27-034 

METERS 

1.27-303 

"ESH 

3 

conductivity 

1.00-014 

MH  C/M 

1.C0-C14 

MHO/* 

4 

atomic  number 

1.30*001 

(NONE  1 

1.00*001 

(NONE  1 

S 

oelta  max  >coeff 

2.40*G0Q 

(NONE) 

1.46*301 

(NONE) 

6 

E-max  >0EPTH«-1 

4.00-001 

KEV 

2.21-002 

ANG-Oi 

7 

PANGE 

1.16*002 

ANG. 

9.42*001 

ANG. 

6 

EXPONENT  > PANGE 

8.10-031 

( NCNE ) 

3.41*002 

ANG. 

9 

pange  > exponent 

1.83*002 

ANG. 

8.1Q-301 

(NONE ) 

10 

EXPONENT 

1.86*200 

(NONE) 

1.86*002 

(NONE) 

11 

YIELO  FOP  1KEV  PROTONS 

4.55-C31 

(NONE) 

4.55-0C1 

(NONE ) 

12 

MAX  DE/DX  FOP  PROTONS 

1. 43*002 

K£V 

1.40*002 

KEV 

13 

PHOTOCUPPENT 

c.oa-cas 

A/***2 

2.00-005 

A/m«*2 

14 

SURFACE  RESISTIVITY 

1 .C0*C19 

OHMS 

8.65*306 

v-s/c 

15 

SPACE  DISCHARGE  PQT'L 

1.00*004 

VOLTS 

1.02*004 

VOLTS 

16 

INTERNAL  OISCHAQGEPOT’L 

Z .22*003 

VOLTS 

2.30*003 

VOLTS 

17 

PAON  INOUCEUCOND’YCOEFFT 

1 .00-312 

MH0MS3 

1. CD-212 

-H0MS3 

id 

PAON  I NDUCEDCONO  *YPO*£R 

I .uC*COC 

(NONE) 

l.oo^oac 

(NONE  ) 

19 

DENSITY 

i.ao*oc2 

KG/"*3 

1 •33*033 

KG/M*3 

20 

2 « 30*001 

1.30-014 
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TABLE  4.2 


MATERIAL  PROPERTIES  (Continued) 


"ATERHl  U:  SOLA 


PROPERTY 

input  value 

CODE  VALUE 

1 

OIELECTRIC  CONSTANT 

3.80*000 

CNON£) 

3.S0*300 

(NONE) 

2 

THICKNESS 

1.79-CC4 

METERS 

1. 79-303 

MESH 

3 

CONOuCTI VlTr 

1 . uC-C 1 7 

MhO/M 

1. 33-317 

MH  0/M 

4 

ATOMIC  NUMBER 

1.00*001 

{NONE ) 

1.00*301 

(NONE  ) 

5 

OELTA  ha X >C0EPP 

2.05*030 

(NONE) 

1.31*301 

(NONE) 

6 

E-MAX  >0EPTh**-1 

4.1C-C01 

K£V 

3.17-302 

ang-ci 

7 

RANGE 

7 .75*031 

ANG* 

3.49*031 

ANG. 

8 

EXPONENT  > PANGE 

4.SC-001 

(NONE) 

2* 73*302 

ANG. 

9 

RANGE  > EXPONENT 

1.56*032 

ANG. 

4.53-001 

(NONE) 

IQ 

EXPONENT 

1 « 73*030 

(NONE) 

1.73*000 

(NONE) 

11 

YIELD  FOR  IK E V PROTONS 

2.44-C01 

(NONE) 

2. 44-CC1 

( NONE) 

12 

ha  X OE/DX  FOR  PROTONS 

2.33* 0C2 

KEV 

2.30*332 

* E V 

13 

PhOTOCURPENT 

2 .30-005 

A/M*»2 

2.G3-3C5 

A 

14 

surface  resistivity 

1 • 0 C * C 1 9 

Ohhs 

9.3  5 ♦006 

v-s/c 

15 

SPACE  DISCHARGE  POT’L 

1 • 3C  *034 

VOLTS 

1.03*304 

VOLTS 

16 

Internal  DISCHARGER©!*! 

2.3C*0C3 

VOLTS 

2.03*303 

VOLTS 

17 

RAON  INDuCEDCGNQ* yCOEFFT 

I.CC-C13 

MH0MS3 

1 .00—31 3 

NHCMS3 

18 

RAON  INOUCEDCONO*YPo«Ec? 

i.30*CG0 

(NONE) 

;. 03*333 

(NONE ) 

19 

density 

1.3C*CC3 

KG/M*3 

1.00*303 

KG/H*5 

20 

2 *wC*0;il 

1.00-017 

MATERIAL  12:  TEFL 

PROPERTY 

INPUT  VALUE 

CODE  VA 

iLUE 

1 

OIElEctRIC  constant 

2 03*000 

(NONE) 

2.03  *OCC 

(NONE ) 

2 

THICKNESS 

1.27-004 

METERS 

1.27-303 

MESH 

Z 

CONDUCTIVITY 

1 *00-016 

MHC/M 

1. 30-316 

MHO/  M 

4 

atomic  number 

7 • GO*QQO 

(NONE  ) 

7.00*003 

(NONE) 

5 

delta  max  >coeff 

3.30*000 

(NONE) 

2.27*001 

(NONE  ) 

6 

E-max  >0EPTh**-1 

3*30-00 1 

KEV 

3 . 83-332 

ANG-E1 

7 

RANGE 

4.54*001 

ANG  • 

l.al *C3i 

ANG. 

8 

EXPONENT  > PANGE 

4 *3C-0u 1 

(NONE) 

3.65*002 

ANG. 

9 

RAN6E  > EXPONENT 

2 « 13  + 302 

ANG* 

4 • 03*00 1 

(NONE) 

10 

EXPONENT 

1.77*030 

(NONE) 

1.77*000 

(NONE  > 

11 

YIELO  FOR  IK  £ V PROTONS 

4.S5-001 

(NONE) 

4.S5-C01 

(NONE) 

12 

MAX  OE/OX  FOR  PROTONS 

1 .40*032 

KEV 

1 .43*002 

K£V 

13 

photocurrent 

2*00-005 

A/M**2 

2*30-005 

A/M**2 

14 

SURFACE  RESISTIVITY 

1.00*016 

OHMS 

8.85*003 

V-S/O 

15 

SPACE  DISCHARGE  POT*L 

1.00*034 

VOLTS 

1.30*004 

VOLTS 

16 

internal  0 ischargepot*l 

2 .30*003 

VOLTS 

2.00*003 

VOLTS 

17 

RAON  INOUCEDCONO* YCOEFFT 

1 • 3 C -C 1 3 

MH0MS3 

1. 03-013 

MH0MS3 

18 

RAON  INOUCEDCOND’YPOwER 

i.DC*CCO 

(NONE) 

2.00 *C  CO 

(NONE  ) 

19 

density 

x « «jO  * 033 

KG/M*3 

1 • OC  *00  3 

KG/H*3 

20 

2 .33*03 I 

1.00-016 
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TABLE  4.2.  MATERIAL  PROPERTIES  (Concluded) 


MATERIAL  13:  S1L V 


PROPERTY 

INPUT  VALUE 

COOE  VALUE 

i 

DIELECTRIC  CONSTANT 

i.2C*CCC 

(NONE) 

i.ao*oco 

(NONE) 

2 

THICKNESS 

i.ac-003 

METERS 

i.ao-ao2 

MESH 

3 

conductivity 

-i.ao*ooo 

MHO/M 

“1 .00*000 

MhO/M 

4 

ATOMIC  NUMBER 

4 • 70 ♦COX 

(NONE) 

4.70*001 

(NONE  ) 

s 

delta  max  >coeff 

1. 20*000 

(NONE) 

3.09*000 

(NONE) 

6 

E-MAX  >0EPTH**-1 

8.20-001 

KEV 

1.58-002 

ANG-01 

7 

RANGE 

8.45*001 

ANG  . 

6.93*001 

ANG. 

8 

EXPONENT  > RANGE 

3 .22-001 

(NONE) 

1.38*002 

ANG  » 

9 

RANGE  > exponent 

7 . 94*CQ 1 

ANG. 

8.Z0-CG1 

(NONE ) 

10 

EXPONENT 

1 • 74*000 

(NONE) 

1.74*C00 

(NONE) 

11 

YIELD  FOR  IK  EV  PROTONS 

4.9C-CC1 

(NONE) 

4 .9C-001 

(NONE ) 

12 

MAX  DE/OX  FOR  PROTONS 

1. 23*002 

K£V 

1.23*002 

*EV 

13 

PHCTOCuRRENT 

2.90-025 

A/ M m*Z 

1.9H-0C5 

A/M**2 

1* 

SURFACE  RESISTIVITY 

-i.2C*0CC 

OHMS 

-8.85-013 

V-S/C 

IS 

SPACE  DISCHARGE  POT  *L 

1.00*004 

VOLTS 

1.30*004 

VOLTS 

16 

INTERNAL  OISCHARG£POT*L 

2.20*003 

VOLTS 

2.00*003 

VOLTS 

17 

RACN  IN0UCEDC0ND*YC0EFFT 

1 *20-013 

MH0MS3 

1.00-013 

mhOmSI 

18 

o A ON  InOUCEDCONO’YPOwE0 

1.20*000 

(NONE  ) 

1.03*000 

(NONE) 

19 

20 

DENSITY 

1.20*203 

2.00*021 

KG/N*3 

1.00*003 

-1.00*000 

KG/M*3 
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5.  TRILIN  AND  THE  PLASMA  ENVIRONMENT 


5.1  TRILIN 

TRILIN  is  the  module  that  calculates  charging  In  this  sense  it 
is  at  the  core  of  the  NASCAP  program.  It  uses  the  object  definition, 
capacitance  and  shadowing  information,  calculated  by  the  modules 
OBJDEF,  CAPACI,  and  HIDCEL,  to  determine  the  current  collected  by  the 
object,  and  the  electrical  potential  throughout  the  computational 
space . 


TRILIN  also  reads  the  Flux  Definition  file.  This  is  the  second 
major  user  input  file  and  describes  the  plasma  environment. 

5.2  NASCAP  ENVIRONMENTS 


NASCAP  is  able  to  simulate  the  charging  of  objects  in  space  and 
in  a test  tank.  For  charging  in  space  the  user  is  able  to  define  the 
energy  distribution  function  of  the  ambient  plasma  (or  plasma 
spectrum)  and  its  angular  distribution.  In  a test  tank  the  ambient 
plasma  is  derived  from  particle  guns.  Single  or  multiple  gun  tests 
may  be  simulated,  involving  electrons,  ions  or  both.  Each  of  these 
options  is  examined  in  detail  in  the  following  sections. 

5.3  FLUX  DEFINITION  FILE 

Information  describing  the  plasma  environment  is  written  in  file 
IFLUX  (Chapter  2)  and  is  read  by  NASCAP  module  TRILIN.  TRILIN  is  the 
module  that  actually  carries  out  the  calculations  of  potentials  and 
currents.  Just  like  the  other  user  input  files  (2.6)  IFLUX  contains 
sequences  of  secondary  keywords  and  their  parameter  cards.  TRILIN 
reads  and  interprets  these  keywords.  The  flux  definition  file  IFLUX 
is  best  summarized  individually  for  each  environment  type.  Let  us 
examine  each  of  these  in  turn  beginning  with  plasma  spectra. 
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5.4  PLASMA  SPECTRUM 


The  energy  distribution  function  of  a set  of  like  particles  i, 
f (E),  is  the  number  density  having  energy  between  E and  E + dE. 

The  flux  due  to  these  particles  across  any  plane  is  given  by: 

I1(E)  f-i(E) 

m 


Each  set  of  particles  (electrons  and  ions)  may  have  its  own 
distribution  function  f. (E).  NASCAP  allows  two  types  of  analytical 
representation  for  f. (E).  An  arbitrary  definition  of  f.(E)  is 
also  possible  via  tabular  input  of  f^(E)  versus  E.  The  two 
analytical  forms  are  single  Maxwellian  and  double  Maxwellian. 

5.4.1  SINGLE  MAXWELLIAN  (TYPE  2) 

The  SINGLE  MAXWELLIAN  representation  has  the  form 


where  N^  is  the  density  of  particle  species  i,  T is  their 
temperature  and  m.  their  mass. 

The  user  is  required  to  tell  NASCAP  the  density  and  temperature 
for  both  ions  and  electrons.  NASCAP  assumes  that  all  ions  are  protons! 


This  information  is  entered  in  the  flux  definition  file 
following  one  of  these  three  keywords. 


SINGLE 

MAXWELLIAN 


TYPE  2 


) 


call  single  Maxwellian  plasma 
spectrum 


Note  that  only  the  first  four  characters  in  each  word  are  significant. 
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Both  are  equivalent  and  tell  TRILIN  to  assume  a Maxwellian 
environment  for  both  ions  and  electrons  and  to  expect  at  least  two 
parameter  cards  to  follow  immediately. 

The  parameter  cards  have  the  form: 

"quantity"  "units" 

Four  quantities  must  be  specified  on  four  cards: 

Electron  Temperature 
Ion  Temperature 
Electron  Density 
Ion  Density 

The  units  understood  by  TRILIN  are  as  follows: 


Density 

. Temperature 

"CGS"  (cm-3) 

"KEV" 

"MKS"  (m-3) 

"EV" 

"JOULES" 

"ERGS" 

"KELVIN" 

Each  card  consists  of  a number  followed  by  a unit.  The  unit  tells 
TRILIN  whether  the  number  refers  to  a temperature  or  a density.  For 
example 

"5  KEV" 

is  understood  as  a temperature  of  5 keV.  But 
"5  MKS" 

_3 

is  understood  as  a density  of  5 m . 

The  first  density  and  temperature  read  by  TRILIN  following  the 
single  Maxwellian  keyword  are  assigned  to  the  ELECTRONS.  The  last 
density  and  temperature  are  assigned  to  the  IONS.  TRILIN  expects  to 
find  at  least  one  density  and  one  temperature  (in  which  case  both  ions 
and  electrons  are  assumed  the  same  parameters).  Any  less  will  cause 
an  error.  More  than  two  of  either  results  in  middle  cards  being 
ignored. 
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For  example, 

SINGLE 
1.  CGS 
10.  KEV 
END 

_3 

defines  a plasma  with  density  1 cm  and  temperature  10  keV. 
The  file 

SINGLE 

0.1  CGS 
3.0E+5  MKS 
2000  EV 

3.5  KEV 
END 

assigns  the  following  quantities: 

-3 

Electron  density  Ng  = 0.1  cm 

Electron  temperature  T = 2.0  keV 

-3 

Ion  density  N^  = 0.3  cm 
Ion  temperature  = 3.5  keV 
The  same  effect  is  brought  about  with  the  file: 

MAXW 
2000  EV 
0.1  CGS 
3.0E+5  MKS 

3.5  KEV 
END 


However 

MAXW 

3.5  KEV 
2000  EV 
0.1  CGS. 
3.0E+5  MKS 
END 
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reverses  the  temperatures: 

N =0.1  cm-3 

T = 3.5  keV 

e -3 

N.  = 0.3  cm 

l 

T.  = 2.0  keV 

Note  that  al_[  plasma  definition  "blocks"  are  terminated  with  an  'END' 
statement. 


5.4.2  DOUBLE  MAXWELLIAN  (TYPE  4) 


The  double  Maxwellian  form  is  the  sum  of  two  single  Maxwellians. 


1 

2 


The  user  must  specify  two  densities  (n|  and  N^)  and  two 
temperatures  (tJ  and  T^)  for  each  particle  species.  Again 
NASCAP  assumes  that  all  ions  are  protons. 


This  information  is  entered  in  the  flux  definition  file 
following  the  keyword: 


uuudlc.  i _ca-ji  double  Maxwellian  plasma  spectrum 
TYPE  4 j 

This  tells  TRILIN  to  assume  a double  Maxwellian  environment  for  both 
ions  and  electrons.  TRILIN  then  expects  four  parameter  cards  to 
follow  immediately. 

The  parameter  cards  have  the  form: 

"species  quantity  units  temperature  units" 

Each  card  must  contain  a temperature  and  a density.  Just  like  the 
single  Maxwellian  spectrum  definition  (5.4.1)  the  units  indicate 
whether  the  preceding  number  is  a density  or  a temperature.  The  same 
set  of  units  as  for  a single  Maxwellian  are  understood  by  TRILIN  for 
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double  Maxwellian.  For  example 

"ELECTRONS  0.1  CGS  1.E6  JOULES" 

defines  one  component  of  a double  Maxwellian  for  the  electrons  having 
a density  (N^)  = 0.1  cm”3,  and  a temperature  (T^)  of  10^ 
joules.  Note  that  the  density  must  precede  the  temperature  definition 
on  the  card.  Four  parameter  cards  completely  define  the  eight 
parameters  required  for  a double  Maxwellian.  The  order  is  unimportant 
since  no  significance  is  attached  to  which  density  and  temperature  are 
associated  with  Maxwellian  components  one  and  two.  For  example 


DOUBLE 

ELECTRONS 

0.2E6 

MKS 

8 KEV 

IONS 

6 

CGS 

0.3  KEV 

ELECTRONS 

0.5 

CGS 

6000  EV 

PROTONS 

1.E6 

MKS 

10  KEV 

END 

defines  a double  Maxwellian  with  the  following  parameters: 


N®  = 0.2  cm-3 
T®  = 8 keV 
N|  = 0.5  cm-3 
T®  = 6 keV 


Nj  = 0.6  cm"3 
Tj  = 0.3  keV 
N^  = 1.0  cm"3 
l'2  = 10  keV 


Note  that  the  words  'IONS'  and  'PROTONS'  are  interchangeable  and  that 
the  whole  "block"  is  terminated  with  an  'END'  card. 

5.4.3  'DIRECT'  MODE  (TYPE  5) 

An  arbitrary  plasma  spectrum  may  be  entered  as  tabulated  data. 

A list  of  values  for  F^E),  Fg(E)  and  E can  be  read  by  TRILIN  and 
"DIRECTly"  integrated  (by  numerical  means)  to  provide  currents.  No 
fitting  to  analytical  forms  is  involved  during  the  integration, 
although  a rough  fit  to  a Maxwellian  is  made  to  provide  parameters  for 
the  direct  numerical  integration  itself. 
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The  data  must  be  entered  in  a very  specific  format.  This  is 
given  in  Figure  5.1.  The  magnetic  field  vectors,  sun  vectors, 
intensity  and  angles  mentioned  are  all  optional.  The  remaining 
information  is  mandatory.  The  tabulated  data  is  read  from  a separate 
file  ISPCTR.  The  default  value  for  ISPCTR  is  9.  The  flux  definition 
file  IFLUX  must  contain  the  following  cards: 

DIRECT 

YEAR  <year> 

DAY  <day> 

TIME  <time  in  seconds> 

END 

The  order  of  the  YEAR,  DAY  and  TIME  cards  are  irrelevant.  For  example 
DIRECT 
DAY  272 

YEAR  1981 

TIME  60013 

END 

in  the  flux  definition  file  will  cause  TRILIN  to  look  in  file  ISPCTR 
for  the  tabulated  data  set  labeled  with  the  date  Day  272  1981  and  time 
60013  seconds.  If  no  such  data  set  exists  an  error  will  occur. 

'DIRECT'  does  not  work  well  with  data  that  is  not  fairly  smooth 
or  is  highly  non-Maxwell i an.  Both  of  these  properties  cause  "multiple 
roots"  or  more  than  one  equilibrium  potential  and  subsequent  potential 
calculations  become  unstable.  It  is  usually  preferable  to  fit 
tabulated  data  to  double  Maxwellian  terms  prior  to  using  the  code. 

5.5  ANGULAR  DISTRIBUTIONS 

Plasmas  having  the  spectra  described  in  Section  5.4  (Maxwellian, 
Double  Maxwellian  and  Direct)  may  have  one  of  two  possible  angular 
distribution  functions. 
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For  NASCAP  operating  in  the  DIRECT  mode  to  be  able  to  read  in 
the  tabulated  data  it  must  be  prepared  according  to  the  following 
specifications  and  format: 

1.  Magnetic  Tape  Characteristics 

Spectra  can  be  provided  on  a coded  9 track  magnetic  tape 
with  the  following  characteristics: 
unlabelled 
1600  bpi 

EBCDIC  or  ASCII  coded 

fixed  length  records:  80  characters  per  record 

fixed  block  size:  20  records  per  block 

2.  Each  data  tape  will  consist  of  header  records  followed  by 
repeated  series  of  data  records.  The  data  will  be  read  by 
a FORTRAN  program  using  the  FORMAT  statements  indicated 
below: 

HEADER  RECORD  1.  DETECTOR  FORMAT  (80A1) 

Identifies  the  detector(s)  used  to  obtain  the  data. 

HEADER  RECORD  2.  SOURCE  FORMAT  (80A1) 

Identifies  the  individual (s)  responsible  for  preparing  the 
data. 

HEADER  RECORDS  3.  through  10.  COMMENTS  FORMAT  {80A1) 

Any  relevant  information  regarding  the  data  can  be  included 
here,  such  as  date  data  tape  was  generated,  detector  mode 
of  operation,  and  what  corrections  have  been  applied  to  the 
raw  data. 

HEADER  RECORD  11.  YEARq , DAYQ,  SECQ,  FORMAT  (10F8.0) 

Year^,  DAY^,  SEC^ 

YEARq,  DAYq,  SECg  = time  of  earliest  spectrum  on  tape 
YEARj,  DAY^,  SEC^  = time  of  latest  spectrum  on  tape 
Each  series  of  data  records  will  represent  a complete 
energy  scan  by  the  detector. 

Figure  5.1.  Format  for  tabulated  spectral  data. 
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DATA  RECORD  1.  YEAR,  DAY,  SEC,  NBINS,  DELTA,  VSAT,  |S|, 

SX,  SY,  SZ  FORMAT  (10F8.0) 

YEAR,  DAY,  SEC  * time  energy  scan  was  begun 
NBINS  = number  of  distinct  energy  bins  in  the  scan 
DELTA  = time  (seconds),  between  each  data  point  in  the  scan 
of  the  spectrum 

VSAT  = satellite  potential  during  scan  (volts) 

\S\  = sun  intensity  (1.0  = full  sun) 

SX,  SY,  SZ  * normalized  sun  direction  vector  components 
at  start  of  scan 

DATA  RECORDS  2.  through  (NBINS+1).  ENERGY,  log1Q(F.), 

lo910(Fe^n’  a*  BX’  BY’  BZ  F0RMAT  U0F8.0) 

Each  of  these  records  represents  a data  point  on  the  scan 
of  the  energy  range 
ENERGY  = energy  (eV) 

F..  * ion  distribution  function  (sec3/m6) 

Fg  * electron  distribuition  function  (sec3/m6) 
ft  * detector  view  angle  (degrees) 

a = pitch  angle  (degrees) 

BX,  BY,  BZ  * magnetic  field  vector  components 
(nT  = 10"9  W/m2) 

(The  a value  is  redundant  since  it  can  be  calculated  from  £2 
and  the  magnetic  field  vector.) 

DATA  RECORD  NBINS+2.  (END  OF  DATA  MARKER)  FORMAT  (10F8.0) 

This  record  will  contain  any  negative  real  number  to 
indicate  the  end  of  the  spectral  scan.  (This  record  is 
redundant  since  NBINS  is  known.) 


Figure  5.1.  Format  for  tabulated  spectral  data  (concluded). 
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5.5.1  ISOTROPIC  INCIDENCE 

NASCAP  assumes  an  isotropic  angular  distribution  function  by 
default.  This  means  that  all  angles  of  incidence  (e)  for  collected 
particles  are  equally  probable;  i.e.,  the  angular  distribution 
function  f(e)  is  a constant.  No  keywords  or  other  statements  are 
required  to  specify  isotropic  incidence. 

5.5.2  ANISOTROPIC  INCIDENCE 

NASCAP  allows  for  an  anisotropic  angular  distribution  function 
f(d)  of  the  form 

2 

f(d)  = a + b cos  d. 

This  describes  a superposition  of  an  isotropic  (spherical)  component 
and  a directional  (dumb-bell)  component.  The  theoretical  background 
to  this  model  is  discussed  in  Section  5.10.1  . The  angle  d is  the 
angle  between  a particle  velocity  and  the  magnetic  field  vector.  The 
direction  of  the  magnetic  field  (and  hence  the  "aligned"  direction)  is 
chosen  by  the  user  as  a run  option  ("B  FIELD"  - 6.4.1).  The  default 
direction  is  along  the  Z axis. 

The  remaining  parameters  "a"  and  "b"  are  actually  just  one 
parameter  (R)  for  a normalized  function  f(d).  The  parameter  R is  the 
ratio  of  directional  to  isotropic  flux  (current)  components. 

R = 3 b/a. 

R may  have  different  values  for  ions  and  electrons.  R and  hence  the 
degree  of  anisotropy  may  also  depend  on  the  energy  of  the  particles. 

An  anisotropic  angular  distribution  function  is  specified  by 
including  the  keyword  'ANISOTROPIC'  before  the  END  card  of  a plasma 
spectrum  block.  TRILIN  reads  the  'ANISOTROPIC'  card  and  then  expects 
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to  find  at  least  two  parameter  cards  defining  values  for  R.  For 
example,  the  flux  definition  file: 

SINGLE 

0.1  KEV 

0.3  KEV 

0.1  CGS 

0.2  CGS 

ANISOTROPIC 

KEV  1.  ERATIO  0.5 

KEV  2.  IRATIO  -0.2 

END 

END 

defines  plasma  with  a single  Maxwellian  spectrum  with  densities  and 

temperatures 

ue  « , -3 

N = 0.1  cm 

T6  = 0.1  keV 

N^  = 0.2  cm*^ 

T1  =0.3  keV 

The  angular  distribution  is  the  standard  anisotropic  form  with  a ratio 
R = 0.5  (electrons) 
and 

R = -0.2  (ions). 

Parameter  cards  defining  ratios  for  electrons  have  the  form: 

"units  number  ERATIO  number" 

For  ions  the  form  is  similar  but  with  keyword  'IRATIO' 

"units  number  IRATIO  number" 

TRILIN  expects  to  find  at  least  two  cards,  one  defining  a ratio  for 
electrons  and  one  defining  a ratio  for  ions.  For  any  less  than  this 
an  error  will  occur. 

The  ratio  R may  range  from  -0.9  to  °°.  Negative  values  give 
“loss-cone"  distributions,  positive  values  give  "gain-cone" 
distributions  and  R = 0 describes  an  isotropic  distribution.  This  is 
discussed  further  in  Section  5.10.1. 
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The  first  two  parameters  on  the  card  specify  an  energy  to  be 
associated  with  the  R value.  The  units  of  energy  accepted  are  'ERGS', 
'JOULES',  'KEY',  'EY’  and  'KELVIN'.  Up  to  ten  RATIO  cards  may  be 
included  in  the  plasma  spectrum  block  for  each  species.  In  this  way  R 
may  depend  on  energy.  The  R values  known  for  particular  energies  may 
be  entered  on  different  cards  and  NASCAP  will  linearly  interpolate 
between  them  for  intermediate  energies.  For  example,  the  cards 
ANISOTROPIC 
1 KEY  ERATIO  1 
3 KEY  ERATIO  0.5 
5000  EV  ERATIO  0.9 
0.1  KEY  IRATIO  0 
END 

give  the  following  energy  dependence  for  R for  the  electrons 


Energy  (keV) 

R Value 

0 

1 

0.5 

1 

1.0 

1 

2.0 

0.75* 

3.0 

0.5 

3.5 

0.6* 

4.0 

0.7* 

5.0 

0.9 

100.0 

0.9 

♦linearly  interpolated  values. 

Note  that  all  energies  equal  to-  and  below  the  lowest  declared  energy 
(1.0  keV)  are  assigned  the  same  R value.  In  the  same  way  all  energies 
equal  to  and  above  the  highest  declared  energy  are  assigned  the  same 
associated  R value.  Thus  if  only  one  ratio  card  is  declared  (such  as 
for  the  ions  in  the  example  above)  the  energy  value  is  irrelevant 
since  all  energies  are  assigned  the  same  R value. 

In  our  example  the  ions  are  chosen  to  have  isotropic  incidence. 
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NASCAP  does  not  order  the  cards  according  to  energy.  For 
sensible  results  the  cards  for  each  species  must  be  entered  in 
ascending  order  of  energy.  It  is  possible  to  read  the  anisotropic 
flux  ratio  (or  parameter)  cards  from  a separate  file.  This  is 
achieved  by  including  a file  number  after  the  keyword  'ANISOTROPIC', 
e.g., 

ANISOTROPIC  19 

will  cause  TRILIN  to  look  for  parameter  cards  in  file  19.  As  soon  as 
an  'END'  card  is  encountered  TRILIN  returns  to  the  file  containing  the 
'ANISOTROPIC'  card  and  continues  to  read  from  there.  Blocks  of 
anisotropic  flux  ratio  cards  must  always  be  terminated  with  an  END 
card. 


If  no  file  number  is  included  following  the  'ANISOTROPIC' 
keyword,  TRILIN  expects  the  ratio  cards  to  follow  immediately  in  the 
same  file.  An  'END'  card  is  sti 1 1 needed  however.  Note  in  our  first 
example  the  presence  of  two  'END'  cards:  one  for  the  anisotropic  flux 

and  one  for  the  plasma  spectrum.  Figure  5.2a,b,c  show  three  sample 
files  associated  with  a DIRECT  plasma  spectrum  and  an  ANISOTROPIC 
angular  distribution. 

5.6  UPDATE 

In  Chapter  1 we  discussed  how  NASCAP  calculates  currents  and 
potentials  for  sequences  of  timesteps.  Each  timestep  has  a chosen 
duration  of  'DELTA'  seconds.  A single  NASCAP  run  may  be  made 
specifying  that  'NCYC'  cycles  or  timesteps  should  take  place.  The 
elapsed  time  of  the  charging  simulation  at  the  end  of  the  run  would 
then  be  NCYC  x DELTA  seconds.  Parameters  NCYC  and  DELTA  are  chosen  by 
the  user  as  run  options  (6.2.2  and  6.2.7).  For  example  if  NCYC  is 
chosen  to  be  5 and  DELTA  is  chosen  to  be  10  seconds,  then  at  the  end 
of  the  NASCAP  run  the  elapsed  time  would  be  5 x 10  = 50  seconds  and  5 
timesteps  would  have  taken  place.  Sometimes  NASCAP  adjusts  the 
timestep  for  one  or  two  timesteps  itself  to  accommodate  rapid  changes 
in  potential  (LONGTIMESTEP  - Section  6.2.6).  If  this  happens  the 
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InP! 
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COMMENTS) I TRIED  TO  GIVE  MORE  CLOSELY  SPACED  DATA  UHEN 
COMMENTS) THE  POTENTIAL  IS  CHANGING  MOST  RAPIDLY 
COMMENTS )UE  COME  OUT  OF  ECLIPSE  ABOUT  17s ■tS 
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Figure  5.2a.  File  9 (ISPCTR). 
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DIRECT 
TIME  59473 
DAY  87 
YEAR  1979 
ANISOTROPIC  19 
END 


Figure  5.2b.  File  22  (IFLUX). 
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EV 
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EV 

3000 
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EV 

END 

40000 

IRATIO  0.06 

Figure  5.2c.  File  19  (IANISO). 


elapsed  time  might  be  less  than  50  seconds.  The  elapsed  time  is  not 
always  under  the  control  of  the  user. 

Usually  TRILIN  reads  the  first  environment  description  it  finds 
in  the  flux  definition  file  (IFLUX)  and  uses  this  same  plasma  spectrum 
and  angular  distribution  for  all  of  the  timesteps  requested  (NCYC). 
However  for  extended  simulations  of  charging,  the  plasma  environment 
experienced  by  a spacecraft  may  change,  sometimes  quite  rapidly. 

NASCAP  is  able  to  change  plasma  descriptions  automatically  between 
timesteps  when  operated  in  'UPDATE'  mode. 

'UPDATE'  mode  is  selected  by  including  the  keywords 

UPDATE  ON 

in  the  options  file  (6.4.14).  Once  NASCAP  is  in  UPDATE  mode,  TRILIN 
looks  for  a fresh  environment  after  every  timestep.  TRILIN  looks  for 
environment  parameter  cards  in  the  file  ISPCTR.  ISPCTR  may  be  chosen 
to  be  any  file  number  as  a run  option  (6.7).  The  default  is  file  9. 
TRILIN  begins  the  first  timestep  by  reading  the  flux  definition  file 
however.  Here  it  expects  to  find  two  cards: 

Plasma-type  keyword 
TIME  seconds 

The  first  card  is  one  of  the  plasma- type  keywords  such  as  'DOUBLE'  or 
'DIRECT'.  This  tells  TRILIN  what  type  of  plasma  spectrum  it  will  be 
looking  for  in  ISPCTR.  The  second  card  tells  TRILIN  the  time  in 
seconds  to  begin  the  simulation.  No  'END'  card  is  needed  to  terminate 
the  file.  For  example  the  file 
DOUBLE 
TIME  58003 

tells  TRILIN  to  expect  parameter  cards  for  a double  Maxwellian  plasma 
in  file  ISPCTR  and  to  begin  the  simulation  at  absolute  time  58003 
seconds  on  the  day  of  interest. 

File  ISPCTR  contains  blocks  of  parameter  cards  labeled  with  the 
times  (in  seconds)  that  the  spectra  they  represent  are  associated 
with.  The  general  form  is  given  by: 
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TIME  n 

{ parameter  cards 
END 

TIME  n' 

{parameter  cards 
END 

TIME  n“ 


For  example: 


TIME  57050 

ELECTRONS 

0.1 

CGS 

1.2  KEY 

ELECTRONS 

0.1 

CGS 

2.2  KEY 

IONS 

0.1 

CGS 

3.0  KEY 

IONS 

0.1 

CGS 

1.0  KEY 

END 

TIME  58000 

ELECTRONS 

0.2 

CGS 

5.0  KEY 

ELECTRONS 

0.1 

CGS 

3.6  KEY 

IONS 

0.3 

CGS 

1.8  KEY 

IONS 

0.2 

CG  S 

4.2  KEY 

END 

TIME  58050 
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For  the  first  timestep,  beginning  at  58003  TRILIN  looks  in  file  ISPCTR 
for  the  most  recent  spectrum  before  58003  seconds.  In  our  example 
this  would  be  the  one  for  58000  seconds,  since  the  next  occurs  at  a 
time  later  than  58003.  The  four  cards  following  the  'TIME  58000'  card 
are  read  and  the  double  Maxwellian  environment  parameters  set.  Since 
no  anisotropic  parameters  are  included  in  the  58000  block  the  angular 
distribution  is  assumed  to  be  isotropic.  Suppose  that  after  the  first 
timestep  the  elapsed  time  has  been  increased  by  10  seconds.  The  new 
value  is  58013.  TRILIN  again  searches  ISPCTR  for  the  most  recent 
environment  before  the  elapsed  time.  Again  this  is  the  one  for  58000 
so  the  same  set  of  parameters  are  read  in  once  more.  If  after  several 
timesteps  the  elapsed  time  exceeds  58050  then  the  next  environment  in 
the  file  would  be  read  in  and  the  parameters  would  change. 

• 

In  this  way  the  most  up-to-date  environment  is  always  the  one 
used  by  TRILIN  for  each  cycle. 

If  the  time  chosen  in  the  flux  file  to  begin  the  simulation  is 
before  the  earliest  time  in  ISPCTR  an  error  will  occur.  If  the 
elapsed  time  exceeds  the  latest  time  the  environment  will  remain  the 
same  as  the  latest  available. 

The  environment  description  included  in  file  ISPCTR  must  be  in 
ascending  time  order.  Anisotropic  parameter  cards  may  be  included  but 
they  must  be  part  of  the  block  and  not  in  a separate  file;  i.e., 

ANISOTROPIC  ianiso 

will  cause  trouble  in  an  update  ISPCTR  file  if  IANISO  p ISPCTR. 

Files  of  'DIRECT'  tabulated  data  are  perfectly  acceptable.  In 
fact  the  ISPCTR  file  shown  in  Figure  5.2a  as  an  example  needs  no 
modification  to  be  read  in  UPDATE  mode  (no  'TIME'  cards  are  needed 
since  each  block  is  already  labeled).  'DIRECT',  'UPDATE'  and 
'ANISOTROPIC'  cannot  all  be  used  together,  however. 
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5.7  TEST  TANK 


The  particle  pushing  test  tank  environment  was  among  the  first 
features  of  NASCAP.  It  was  restricted  to  a single  electron  gun  at  the 
-Z  boundary  of  the  computational  space  firing  at  a convex  target.  The 
input  was  so  complex  that  only  a handful  of  guns  were  ever  defined.  A 
description  of  the  original  test  tank  capability  may  be  found  in  the 
1982  version  of  this  manual.  More  recently,  an  analytic  (Type  6)  test 
tank  was  incorporated  in  NASCAP.  This  new  facility,  described  in 
Section  5.9,  allowed  multiple  beam  electron  and  ion  guns  at  arbitrary 
grounded  locations,  in  or  out  of  the  computational  space,  and  had 
simple,  flexible  input.  Being  an  analytic  method,  it  was  fast  and 
free  of  the  sampling  errors  inherent  in  particle  techniques.  However, 
as  it  assumed  a simple  form  for  electron  and  magnetic  fields,  it  was 
of  questionable  accuracy  for  non-convex  or  differentially  charged 
objects. 

During  1983  a new  formulation,  replacing  the  original  Type  1, 
was  written  with  the  full  multigun  capability  of  the  analytic  method 
while  retaining  the  ability  to  faithfully  treat  complex  geometry  and 
field  structure  by  particle  tracking.  Efficient  data  storage  and 
buffering  schemes  keep  the  time  and  storage  requirements  within 
practical  limits,  and  new  current  sharing  algorithms  ameliorate 
sampling  errors.  This  capability  greatly  expands  the  applicability 
and  use  of  NASCAP  for  simulation  of  charging  by  low  intensity  electron 
and  ion  beams. 
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5.8  TEST  TANK  (TYPE  1) 


5.8.1  USAGE 

The  usage  of  the  new  (Type  1)  test  tank  simulation  is  nearly 
identical  to  the  analytic  (Type  6)  capability.  For  definition  of  gun 
characteristics,  etc.,  refer  to  NASCAP  Programmer’s  Reference  Manual, 
Section  5.9.  Note  that  for  both  Type  1 and  Type  6,  the  environment  is 
specified  by  the  TANK  module  prior  to  calling  TRILIN,  and  the 
environment  TYPE  must  be  specified  in  the  option  (RDOPT)  input. 


The  differences  between  Type  1 and  Type  6 usage  are: 

a.  In  the  flux  (TANK  module)  input,  the  NOSHADOW  option  should  be 
specified.  Omission  of  this  will  result  in  an  unnecessary 
shadowing  calculation  (and  accompanying  plot)  for  each  gun. 

b.  In  the  options  (RDOPT  module)  input,  the  TANKTRAJ  OFF  or 
TANKTRAJ  ON  specifications  may  be  used  to  obtain  particle 
trajectory  plots.  Presently  only  the  X-Z  projection  is 
plotted.  (Current  density  plots  are  neither  available  nor 
planned. ) 

c.  Three  new  keywords  are  available  in  the  flux  (TANK  module)  input 
which  relate  to  particle  tracking.  These  are  shown  in  Table 
5.1.  The  default  values  should  be  acceptable  in  most  cases. 
Values  within  the  recommended  ranges  will  usually  result  in 
avoiding  either  excessive  time  or  excessive  inaccuracy  in  the 
particle  current  calculations. 


TABLE  5.1.  PARTICLE  TRACKING  KEYWORDS 


Keyword 

Default 

Recommended  Range 

Meaning 

VCODE 

0.2 

0.1  < VCODE  < 0.3 

Initial  code  velocity 
(mesh  units  per  st) 

NSTEPS 

500 

200  < NSTEPS  < 1000 

Maximum  number  of  pushing 
steps  per  particle 

NTHETA 

8 

5 < NTHETA  < 15 

Number  of  particles  per 
beam  is  approximately 
(W  4)  NTHETA^ 
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The  parameter  VCODE  governs  the  accuracy  of  particle  tracking, 
with  smaller  values  giving  more  accuracy.  VCODE  is  the  initial  code 
velocity  for  each  particle,  and  will  increase  for  attracted  particles 
and  decrease  for  repelled  particles.  We  recommend  that 

(Ef/Ei)1/2  VCODE  < 0.5 

for  attracted  particles,  and 
(Ef/E.)  VCODE  >0.1 

for  repelled  particles,  where  E^  and  Ef  are  the  initial  and 
estimated  final  kinetic  energies. 

NSTEPS  is  the  maximum  number  of  steps  for  each  particle.  Ample 
steps  should  be  allowed  for  the  particle  to  cross  the  computational 
space;  a smaller  VCODE  requires  a larger  NSTEPS. 

NTHETA  is  the  number  of  angular  points  across  the  beam,  and 
determines  how  many  particles  are  tracked.  It  should  be  set  by 

D tan  (2W/NTHETA)  < 1 


where  D is  the  approximate  gun-target  distance  (grid  units),  and  W is 
the  half-angle  of  the  beam. 

5.8.2  EXAMPLE 

Figures  5.3  and  5.4  show  particle  trajectories  and  resulting 
potential  contours  for  four  guns  illuminating  a partially  covered 
octagon.  Note  that  the  figures  show  the  correct  octagonal  symmetry. 
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PARTICLE  TRAJECTORIES 


Figure  5.3.  Particle  trajectories  for  Type  1 test  tank  (four 
single-beam  guns)  example. 


X-fIXIS 

-4.21*003  < CONTOUR  LEVELS  < -2.52+003  RT  POTENTIAL  INCREMENTS  OF  OP  - 1.00*002 

1*00  <X<  17.00,  1.00  <2<  17.00,  CUTPUWE  OFFSET  Y-  11.00 


Figure  5.4.  Potential  contours  for  Type  1 test  tank  example. 


5.8.3 


COMPARISON  - TYPE  1 VERSUS  TYPE  6 


It  was  originally  expected  that  the  new  Type  1 would  require  far 
more  computer  time  than  Type  6,  especially  for  multibeam  cases. 

Initial  experience  indicates  that  the  time  difference  is  very 
moderate,  with  the  difference  very  small  compared  to  the  total  NASCAP 
running  time.  Also,  the  sampling  and  sharing  techniques  used  in  the 
new  Type  1 seem  successful  at  minimizing  particle  noise.  In  the 
example  above,  for  which  both  methods  should  be  reasonably  accurate, 
nearly  identical  results  were  obtained. 

We  suggest  that  Type  1 should  usually  be  used  whenever 
potentials  are  suspected  of  being  sufficiently  non-monopole- like  to 
affect  the  results.  The  advantage  of  Type  6 is  that,  while  Type  1 
guns  must  be  located  at  grounded  points  or  outside  a grounded  outer 
boundary.  Type  6 calculations  can  often  be  run  in  fewer  (usually  one) 
grids  using  monopole  boundary  conditions  (IOUTER  = 2).  The  number  of 
grids  in  the  computational  space  is  a very  significant  factor  in  the 
cost  of  running  NASCAP. 
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5.9  TEST  TANK -6  (TYPE  6)  - MODULE  "TANK" 


5.9.1  GENERAL  CONSIDERATIONS 

Test  Tank-6  (TYPE  6)  allows  for  multiple  guns  emitting  multiple 
beams.  Each  gun  may  emit  either  electrons  or  ions.  The  currents  to 
the  surface  of  the  object  are  calculated  analytically  rather  than  by 
particle  tracking  (Section  5.8)  and  the  calculation  is  both  faster  and 
more  economical  than  Test  Tank-1.  However  no  trajectory  or  density 
plots  are  generated  and  the  calculation  is  less  accurate  for  highly 
non-spherical  objects  (i.e.,  objects  that  are  much  larger  in  one 
direction  than  another  - like  a thin  rod)  or  for  cases  with  a great 
deal  of  differential  charging. 

For  objects  that  have  parts  that  may  shield  some  of  its  surfaces 
from  the  beam  particles  (non-convex  objects  (Section  6.4.2)),  optical 
shadowing  calculations  are  carried  out  using  the  HIDCEL  module  (8.1). 
HIDCEL  determines  the  fraction  of  each  surface  cell  that  is 
effectively  exposed  to  the  beam(s)  and  hence  the  fraction  of  the 
theoretical  incident  current  actually  collected.  This  shadowing 
information  is  stored  in  file  IOBPLT  (default  file  number  19). 

Because  of  the  way  NASCAP  is  constructed  it  is  not  practical  to 
execute  HIDCEL  from  inside  TRILIN.  Instead  a separate  module  called 
'TANK'  is  provided  to  read  the  flux  definition  file  IFLUX  and  make  any 
calls  to  HIDCEL  before  TRILIN  is  called  to  actually  carry  out  the 
potential  calculation.  Since  TRILIN  does  not  read  IFLUX  in  a Test 
Tank-6  case  the  flux  type,  telling  NASCAP  that  this  is  a Test  Tank-6 
run,  must  be  included  as  a run  option.  The  card 

TYPE  6 

must  be  included  in  the  options  file  (6.4.13). 


A sample  runstream  might  have  the  form: 

@XQT  NASCAP*NASCAP . ABS  (UNIVAC  ONLY) 

RDOPT  {file  includes  TYPE  6 card} 

OBJDEF 

CAPACI 

TANK  {reads  IFLUX  and  calls  HIDCEL  } 

trti  tn  I carries  out  potential  calculations  using 
( information  read  by  TANK 

END 


If  the  object  in  the  tank  is  to  be  illuminated  with  UV  light 
(sunlight)  then  any  calls  to  HIDCEL,  SPIN  or  ROTATE  (Chapter  8)  must 
come  after  the  call  to  TANK,  but  before  the  call  to  TRILIN.  'TANK' 
destroys  any  previous  shadowing  information;  e.g., 

@ XQT  NASCAP*NASCAP.ABS. 

RDOPT 

OBJDEF 

CAPACI 

TANK 

HIDCEL 

TRILIN 

END 

The  calls  to  HIDCEL  made  by  TANK  as  part  of  the  particle  current 
calculation  are  made  automatically  and  require  no  user  intervention. 

Subsequent  Test  Tank-6  runs,  using  the  same  object  and  the  same 
gun  and  tank  arrangements , may  be  made  without  a call  to  TANK, 
providing  that 

a.  Shadowing  information  on  file  IOBPLT(19)  is  saved  from 
previous  runs  (i.e.,  IOBPLT  is  a restart  file),  or 

b.  the  object  is  convex  and  no  shadowing  takes  place. 
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For  example: 

@XQT  NASCAP*NASCAP . ABS 

RDOPT  (Option  file  with  'TYPE  6'  card) 

TRILIN 

END 

5.9.2  TEST  TANK-6  FLUX  DEFINITION  FILE 

The  flux  definition  file  IFLUX,  read  by  TANK,  consists  of  a 
series  of  blocks,  each  defining  a gun.  Each  block  consists  of  a 
'GUN  AT'  keyword  card  to  start  things  off,  followed  by  four  parameter 
cards,  specifying  the  energy,  width,  current  and  direction  of  the 
beam,  or  beams,  the  gun  is  to  emit.  These  commands  are  summarized  in 
Figure  5.5.  The  general  form  is  as  follows: 

<species>  GUN  AT  x y z 

ENERGY  e,  e,  ...  e„  unit. 

12  n 

BEAMWIDTH  bi  b 2 •••  bn  unit* 

CURRENT  c,  c.  ...  c unit 
11  n 

DIRECTION  x y z 
<species>  GUN  AT  x'  y'  z' 


END 
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OFFSET  ix  iy  iz 

Should  be  first  card  in  file.  Defines  position  relative  to 
which  gun  locations  are  defined.  Default  is  mesh  center. 

OFFSET  000  will  make  gun  positions  defined  in  "absolute"  grid 
location. 

GUN  AT  x y z 

ELECTRON  GUN  AT  x y z 
ION  GUN  AT  x y z 

Defines  position  and  type  of  gun.  If  gun  type  not  specified, 
electron  gun  is  assumed. 

ENERGY  ) e1  ...  ep  unit 
ENERGIES  ) 

Defines  beam  energies  of  gun.  Unit  is  'EV1  or  'KEV'.  The 
default  unit  is  'KEV'. 

BEAMWIDTH(S)  bj_  ...  bn  unit 

Defines  half-angle  of  beam.  Unit  is  assumed  to  be  radians, 
unless  'DEGREES'  is  specified. 

ALL  BEAMWIDTHS  b unit 

Assigns  b as  the  beamwidth  for  all  beams  of  this  gun. 

CURRENT(S)  ...  cn 

Specifies  beam  currents  in  amperes. 

ALL  CURRENTS  c 

Assign  c as  current  for  all  beams  of  this  gun. 

NOSHADOW 

Indicates  that  file  IOBPLT  [19]  already  exists  for  guns  at  these 
locations. 

ION  MASS  m unit 

Defines  mass  for  an  ion  gun.  Unit  is  assumed  kilograms  unless 
'AMU'  is  specified. 

DIRECTION  x y z 

Specifies  direction  in  which  gun  is  pointing. 

END 

Ignore  subsequent  cards.  

Figure  5.5.  Surrcnary  of  TEST  TANK  (Type  1 or  Type  6)  flux  definition 
cards.  (See  also  Table  5.1.) 
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Notes: 


1.  <species>  GUN  AT  x y z 

<species>  is  optional  and  may  be  'ELECTRON'  or  'ION'  to  define 
an  electron  or  ion  gun,  respectively.  Omission  of  any  <species> 
assumes  an  ELECTRON  gun. 

<x  y z>  define  the  coordinates* of  the  gun  location  (in  object 
definition  inner  grid  coordinates  - 3.2).  For  example: 

'GUN  AT  -2  0 -8' 

defines  an  electron  gun  at  x = -2,  y = 0 and  z = -8. 

The  gun  may  be  located  outside  the  computational  space. 

2.  ENERGY  e,  e,  e,  ...  e^  unit 

This  card  defines  the  energy  of  the  beam(s)  to  be  emitted  from 
the  gun.  Up  to  30  beams  may  be  defined.  These  can  all  come 
from  one  gun  or  be  shared  by  up  to  ten  separate  guns.  Each 
number  entered  after  the  parameter  keyword  'ENERGY'  defines 
another  energy  beam,  and  hence  another  beam.  The  <units>  at  the 
end  of  the  energies  is  optional.  The  default  units  are  'KEY'. 
The  only  other  acceptable  unit  is  EV. 

3.  BEAMWIDTH  b,  b.  ...  b <units> 

lx  n 

This  card  has  exactly  the  same  syntax  as  the  ENERGY  card.  The 
number  of  beamwidths  defined  must  correspond  exactly  however  to 
the  number  of  energies  (and  currents)  previously  defined  for 
this  particular  gun.  The  beamwidth  is  the  half  angle  of  the 
conical  beam.  The  unit  is  assumed  to  be  RADIANS  unless  DEGREES 
is  specified  as  <units>. 

4.  CURRENT  c,  c,  ...  c 

i c n 

Again  the  syntax  is  similar  to  that  for  ENERGY  and  BEAMWIDTH. 

The  currents  of  the  beams  must  all  be  in  amps. 
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5. 


DIRECTION  x y z 

This  card  specifies  the  direction  in  which  the  gun  is  pointing, 
(i.e.,  in  coordinates  with  origin  at  the  gun  location,  the  gun 
is  aimed  at  the  point  x y z. 

The  four  parameter  cards  may  be  in  any  order.  As  emphasized 
above,  the  ENERGY,  BEAMWIDTH  and  CURRENT  cards  must  all  indicate  the 
same  number  of  beams. 

5.9.3  'ALL'  CARDS 

When  a set  of  beams  all  have  the  same  energies,  currents  or 
widths,  it  is  sometimes  convenient  to  declare  these  quantities  using 
the  'ALL'  keyword;  e.g., 

ALL  ENERGIES  e units 

ALL  CURRENTS  c 

ALL  BEAMWIDTHS  b units 

The  'ALL'  cards  may  only  be  used  after  at  least  one  parameter  card  in 
conventional  format  has  been  declared  to  establish  the  number  of 
beams.  For  example 

BEAMWIDTHS  bx  bx 
ALL  CURRENTS  c 
ALL  ENERGIES  e EV 

is  part  of  a block  defining  a gun  having  two  beams.  The  same 
definition  will  fail  if  written  in  the  form 
ALL  CURRENTS  C 
BEAMWIDTHS  b:  t>2 

ALL  ENERGIES  e EV 

because  the  current  is  defined  before  the  BEAMWIDTHS  card  establishes 
the  number  (2)  of  beams. 
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5.9.4 


'OFFSET' 


Sometimes  it  is  convenient  to  change  the  coordinate  system  from 
the  0 0 0 centered  one  that  is  active  by  default  to  some  other,  before 
the  guns  are  defined.  (Say  the  absolute  system.)  This  is  achieved 
with  the  OFFSET  command 

'OFFSET  ix  iy  iz' 

OFFSET  works  in  the  Test  Tank-6  flux  definition  file  in  exactly  the 
same  way  as  it  does  in  the  object  definition  file.  This  is  explained 
in  Section  3.9.3. 

5.9.5  ' NOSHADOW ' 

The  shadowing  information  calculated  by  HIDCEL  depends  only  on 
the  location  of  the  guns  defined.  For  multiple  NASCAP  runs  involving 
the  same  number  of  guns  at  the  same  locations  illimiinating  the  same 
object  the  shadowing  calculations  need  not  be  repeated.  If  keyword 
’NOSHADOW'  appears  in  the  flux  definition  file  read  by  TANK,  no  calls 
to  HIDCEL  will  be  made.  Instead  NASCAP  will  assume  that  the  required 
shadowing  information  has  been  written  to  (and  saved  on)  file  IOBPLT 
(19)  by  a previous  run.  This  feature  is  particularly  useful  for 
series  of  runs  where  the  user  wishes  to  change  the  currents,  energies 
and/or  widths  of  the  beam,  but  not  the  location  of  the  guns  on  the 
tank. 

5.9.6  THE  SHAPE  OF  THE  TANK 


Like  Test  Tank-1  the  walls  of  the  tank  are  defined  by  the 
boundary  of  the  computational  space  (3.2).  There  are  no  restrictions 
on  gun  placement  for  Test  Tank-6.  Likewise  the  computational  space 
and  hence  the  tank  itself  may  be  any  NASCAP  allowed  size  and  shape. 

The  cylindrical  tank  option  (6.4.12)  applies  to  Test  Tank-6  as  well  as 
Test  Tank-1.  If  the  tank  walls  are  grounded  this  must  be  reflected  in 
the  NASCAP  calculation  by  choosing  run  option  IOUTER  to  be  0 (6.4.5). 

' IOUTER  O' 
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5.9.7 


TEST  TANK -6  EXAMPLES 


The  first  example  defines  four  guns  pointing  at  the  mesh  center, 
each  from  a distance  of  22.6  grid  units.  After  echoing  the  gun 
definition  input  (which  concludes  with  an  'END'  card  or  end-of-file 
condition),  the  gun  characteristics  are  echoed  for  each  gun,  and  for 
each  beam.  It  is  then  indicated  that  a shadowing  calculation  is  being 
performed  for  each  gun. 

The  second  example  defines  an  ion  gun.  As  the  1 NOSHADOW 1 
specification  is  included,  the  purpose  of  this  input  is  presumably  to 
change  the  beamwidth,  current,  or  energy. 

Example  three  defines  a two-beam  electron  gun  with  different 
current  and  beamwidth  for  each  energy.  Example  four  defines  a 
three-beam  electron  gun  with  equal  currents  and  beamwidths. 
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o cn  ^ cj  rxi  &-  cn  cj  ro  ^ co^O'Cn-^curo-*-  o o o)  (Mn  *'  w h) .»  o *o  m n o«  cn  4>  w to 


1.  GUN  AT  0 16  16 

ENERGY  6.  KEV 
CURRENT  S.E-6 
BEARUIDTH  30  DEGREES 
DIRECTION  0 -1  -1 
GUN  AT  0 -16  16 
ENERGY  6.  KEV 
CURRENT  S.E-6 
BEARUIDTH  30  DEGREES 
DIRECTION  0 1 -1 
GUN  AT  0 -16  -16 
ENERGY  6.  KEV 
CURRENT  S.E-6 
BEARUIDTH  30  DEGREES 
DIRECTION  0 1 1 
GUN  AT  0 16  -16 
ENERGY  6.  KEV 
CURRENT  S.E-6 
BEAHUIDTH  30  DEGREES 
DIRECTION  0 -1  1 
END 

Gun  definition  input  for  example  1. 

ION  GUN  AT  -44.,  0.S,  6.2 
N0SHAD0U 
ION  HASS  14  ARU 
BEARUIDTH  20  DEGREES 
CURRENT  S.E-6 
ENERGY  SOOO  EV 
DIRECTION  3.  0.  1. 

END 

Gun  definition  input  for  example  2. 


ELECTRON  GUN  AT  -20  0.  0. 
DIRECTION  1 0 0 
ENERGIES  0.1  10  KEV 

BEARUIDTHS  40  10  DEGREES 

CURRENTS  1.E-6  O.SE-6 
END 

Gun  definition  input  for  example  3. 


ELECTRON  GUN  AT  SO  3S  4 
DIRECTION  -2  -1  0 
ENERGIES  S 10  20  KEV 
ALL  BEARUIDTHS  2S  DEGREES 
ALL  CURRENTS  i.E-6 
END 

Gun  definition  input  for  example  4. 


176 


••••••TAN*  5 

OBJECT  DEFINITION  INFORMATION  EEInG  READ  FRO**  FILE 
A SHAOO«lNG  TABLE  nAS  PREVIOUSLY  generated 

for  this  object  using  the  guns  option 

GUN  AT  0 16  16 
ENERGY  6.  KEV 
CURRENT  5.E-6 
BEARWIDTh  30  OEGREES 
DIRECTION  0 -1  -X 
GuN  AT  3 -16  16 
ENERGY  6.  KEV 
CURRENT  S.E-6 
BEAMwIOTH  33  OEGREES 
DIRECTION  C 1 -1 


GUN  AT  0 -16  -16 
ENERGY  6.  REV 
CURRENT  5.E-6 
BE ahuIOTh  30  OEGREES 
OIRECTION  Oil 
GUN  AT  0 16  -16 
ENERGY  6.  REV 
CURRENT  5.E-6 
BEAmuIOTh  30  OEGREES 
OIRECTION  C -1  1 
END 


GUN  DEFINITION  

GUN  1 HAS  BEEN  OEFINEO  AS  AN  ELECTRON  GUN 
GUN  IS  LOCATED  AT  GRIO  COORDINATES  9.CC 
GUN  DIRECTION  IS  .DO  -1.C2  -1.3C 

BEAM  1:  ENERGY:  6.00*303  Ev  CURRENT: 

GUN  DEFINITION  

GUN  2 HAS  BEEN  DEFINED  as  AN  ELECTRON  GUN 
GUN  IS  LOCATED  AT  GRID  COORDINATES  9.GC 
GUN  DIRECTION  IS  .03  1.30  -l.DC 

BEAN  1:  ENERGY:  6. G0*C33  Ev  CURRENT: 

6UN  DEFINITION — 

GUN  3 HAS  BEEN  OEFINEO  AS  AN  ELECTRON  GUN 
6UN  IS  LOCATED  AT  GRIO  COORDINATES  9.3C 
GUN  OIRECTION  IS  .00  1.03  1.00 

BEAN  1:  ENERGT:  fc.C0*C03  Ev  CURRENT: 


2S.C0  2S.CC 

5.20- 306  AMPS  CUT-OFF  ANGLES  3G.GCCC 

-7.03  25. OC 

5.20- C06  AHPS  CUT-OFF  ANGLES  33.3CDC 
-7. DC  -7.00 

S. 30-036  AHPS  CUT-OFF  ANGLES  13.3300 


GUN  DEFINITION  

GUN  9 HAS  BEEN  DEFINED  as  AN  ELECTRON  GUN 
GUN  IS  LOCATED  AT  GRIO  COORDINATES  9.30 
GUN  DIRECTION  IS  .3C  -l.OC  l.CC 

BE*"  1a  ENERGT:  6.00*333  Ev  CURRENT: 

shadowing  being  calculated  for  gun  ; 

DISTANCE  EQUALS  22 .627917 


25.00  -7.33 

S.33-C36  AHPS 


CUT-OFF  ANGLES  JO. 3030 


FINAL  NAl  s 2C 

ShAOOwInG  BEING  CALCULATED  FOR  SUN  2 
DISTANCE  EQUALS  22.627917 


FINAL  NAl  s 20 

SHAOO.ING  BEING  CALCULATED  FOR  SUN  3 
DISTANCE  EQUALS  22.627917 


PINAL  NAl  = 2C 

SH A 00. INC  BEING  CALCULATED  FOR  GUN  9 
DISTANCE  equals  22 .627“ 17 


FINAL  NAl  = 2C 

Gun  definition  (INGUNS  and  GUNSHD)  output  for  example  1. 


DEGREES 


DEGREES 


DEGREES 


OEGREES 


177 


••••••TANK  5 

ION  GUN  AT  -44.,  2.5,  6.2 

NOSHAQOa 

ION  NASS  14  AHU 

BEAMWlDTH  20  OEGREES 

CURRENT  S.E-6 

ENERGY  5000  Ev 

OIRECTION  3.  0.  1. 

ENO 


GUN  DEFINITION  

GUN  X HAS  BEEN  OEFINEO  AS  an  ION  GUN  .ITh  An  ION  -ASs= 
GUN  IS  LOCATED  AT  GRID  COORDINATES  -35. SC  9. SC  15.20 

GUN  OIRECTION  IS  2.30  .00  l.CO 

BEAM  I:  ENERGY:  5. 00*003  Ev  CURRENT:  5.30-C56  amps 


2. 34-026  KILOGRAMS. 


CUT-OFF  ANGLE:  20.0002 


Gun  definition  (INGUNS 


and  GUNSHD)  output  for  example  2. 


••■•••TAN*  s 

electron  gun  at  -20  c.  g. 

DIRECTION  100 
ENERGIES  0.1  10  KEV 

BEAMWIOTHS  40  10  OEGREES 

CURRENTS  i.E-6  0. SE-6 

ENO 

GUN  DEFINITION  

GUN  1 HAS  BEEN  OEFINEO  AS  AN  ELECTRON  GUN 

GUN  IS  LOCATED  AT  GRIO  COORDINATES  -11.00  9. CO  9. CO 

GuN  OIRECTION  IS  1.30  .00  .00 

BEAM  1:  ENERGY:  1.00*002  EV  CURRENT:  1.00-036  AMPS  CuT-OFF  ANGL£=  «3.3C0 

BE*N  2t  ENERGY:  l.CC*G04  EV  CURRENT:  5.3C-C3T  ahPS  CUT-OFF  ANGLE:  13.020 

SHAOO-ING  BEING  CALCULATED  FOR  SUN  1 
OISTANCE  EQUALS  23.500030 

FINAL  na 1 : 16 

Gun  definition  (INGUNS  and  GUNSHD)  output  for  example  3. 


■•■•■•tank  s 

ELECTRON  GUN  AT  50  35  « 
OIRECTION  -2  -1  0 
ENERGIES  5 10  20  k£v 
ALL  BEAMWIOTHS  2 5 DEGREES 
ALL  CURRENTS  l.E-6 
ENO 


GUN  DEFINITION  

GUN  1 HAS  BEEN  OEFINEO  AS  AN  ELECTRON  SUN 
GUN  IS  LOCATED  AT  GRIO  COORDINATES  59. 00 


SUN  DIRECTION  IS 
BEAM  1:  ENERGY: 
BEAM  2:  ENERGY: 
BEAM  3:  ENERGY: 


-2.00  -1.00 
5. 03*003  EV 
1.00*004  EV 
2.00*004  EV 


SHAOOaING  BEING  CALCULATED  FOR  GUN 
OISTANCE  EQUALS  61.163713 


00 

CURRENT: 
CURRENT: 
CURRENT: 
1 


44. oc  13. CC 

1.00- C36  AMPS 

1.00- C06  AMPS 
1 .53-006  APRS 


CUT-OFF 

CUT-OFF 

CUT-OFF 


ANGLE: 

ANGlE= 

ANGLE: 


2S.0CE 

25.C23 

25.520 


FINAL  NA 1 : 2e 

Gun  definition  (INGUNS  and  GUNSHD)  output  for  example  4. 


DEGREES 


OEGREES 

DEGREES 


OEGREES 

OEGREES 

OEGREES 
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5.10 


TECHNICAL  DISCUSSION 


5.10.1  ANISOTROPIC  FLUX 

The  NASCAP  model  by  default  allows  for  incident  electron  and  ion 
fluxes  that  are  isotropic;  i.e.,  all  incident  directions  are 
considered  equally  likely.  This  is  not  usually  true  for  orbiting 
satel 1 i tes . 

Injection  of  a charged  particle  into  a static  magnetic  field 
causes  the  particle  to  follow  a spiraling  trajectory  about  the 
magnetic  lines  of  force.  The  component  of  its  velocity  vj  j along  the 
field  direction  is  unchanged  and  the  radius  of  the  spiral  trajectory 
r,  depends  on  the  perpendicular  component  v 

mv^ 
rL  = qB~ 


Thus  for  a fixed  velocity  magnitude,  |v|,  injection  of  a flux  of 
charged  particles  into  a magnetic  field  will  lead  to  fast  moving 
particles  (in  the  field  direction)  with  small  Larmor  radii  (r^),  and 
slower  particles  with  large  radii. 

Similar  events  occur  in  the  earth's  magnetic  field.  Plasma  is 
injected  into  normally  low-density  regions  and  the  particles  begin  an 
orbiting  trajectory  along  the  field  lines.  A satellite  bathed  in  this 
orbiting  plasma  will  experience  a flux  with  two  principal  components: 

a.  A background,  essentially  isotropic,  flux  consisting  of  the 
pre-existing  low  density  plasma,  and  particles  from  the 
injected  plasma,  that  have  r^  much  greater  than  the 
spacecraft's  dimensions. 
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b.  A directional  flux,  aligned  with  the  terrestrial  field, 
consisting  of  particles  with  r^  smaller  than  the 
spacecraft  dimensions.  This  can  be  a negative 
contribution.  If  some  of  the  injected  plasma  has  passed 
the  poles  several  times,  the  faster  moving  particles  will 
have  been  "filtered  out"  leaving  a reduced  flux  in  the 
field  direction  (a  "loss-cone"). 

This  model  is  too  simplistic  to  account  for  all  of  the  varied 
magnetic  phenomena  that  can  occur  in  earth  orbit.  However,  it  does 
illustrate  the  features  that  are  desirable  in  a model  incorporating 
anisotropic  flux  distribution. 

The  form  introduced  into  the  NASCAP  model  consists  of  a 

2 

background  isotropic  component  and  a cos  © distribution  aligned  with 
the  field  direction.  The  shape  of  such  a form  depends  on  just  one 
parameter:  the  ratio  of  integrated  flux  for  each  component,  R. 

5.10.1.1  The  Coordinate  System.  The  most  convenient  coordinate 
system  in  which  to  represent  the  aligned  component  is  the  "fan"-like 
system  shown  in  Figure  5.6.  The  angle  of  incidence  6 of  an  incoming 
vector  r is  related  to  the  two  angles  of  rotation  shown,  © and  0,  by 
the  relationship 

cose  = cos©  costf 

Rotating  the  "fan"  from  a plane  containing  the  surface  normal  to  a 
plane  containing  the  vector  r only  partially  defines  the  angle  ©.  The 
choice  of  © becomes  unique  when  the  second  rotation  (0)  within  the 
plane  of  the  "fan",  to  reach  r,  is  specified.  The  coordinate  system 
is  chosen  so  that  the  magnetic  field  direction  if  has  t = 0.  This 
provides  a reference  point  for  all  other  vectors  in  the  space  above 
the  surface,  and  hence  fully  defines  the  ©,  t>  coordinate  system. 
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Figure  5.6.  The  projection  of  an  incident  vector  r upon  the 
surface  normal,  in  the  "fan-like"  coordinated 
system. 
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5*10*1*2  Angular  Distribution  Function.  The  angular  distribution 
function  is  assumed  to  be  symmetric  about  the  field  direction,  and  so 
the  aligned  component  depends  only  upon  the  angles  made  between  a 
vector  r and  if,  the  field  direction 

cosip  * cos(e-eQ)  cost 

The  form  we  choose  for  the  aligned  component  is  simply  cos2^,  i.e., 
the  angular  distribution  function  f{e,tf)  becomes 

f(«,*J)  = a + b cos2(e-eQ)  cos^d 

Integration  over  the  half-sphere  must  be  normalized  to  2*. 

J*  f(e,d)du  = 2ir 
1/2 


In  the  "fan"  coordinate  system: 
do  = cosirf  d i>  de 


2(e-eQ)  cos2d 


cosd  de  d«f  = 2ir 


• * . 2ira  + 


2irb 

"T"  = 


2 TT 


i .e.. 
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We  define  the  ratio  of  integrated  fluxes  R as 
R = b/3a 

a = 1/(1  + R) 

b = 3R/( 1 + R) 


Thus  overall  the  angular  distribution  function  depends  only  upon  two 
parameters: 

1.  The  angle  eQ  between  the  field  direction  n^  and  the 
surface  normal  n. 

cose0  - nB  • n. 

2.  The  ratio  R. 

While  this  form  for  f(e,d)  cannot  represent  exactly  all  possible 
angular  distributions  it  does,  in  a simple  way,  model  the  most 
commonly  observed  situations  of  enhancement  of  flux  incident  along  the 
field  lines  (R  is  positive)  and  a "loss-cone"  along  the  field 
direction  (R  is  negative).  This  is  illustrated  in  Figs.  5.7  to  5.10. 
As  R increases  from  -0.35  to  0.5  the  distribution  changes  from  a 
"doughnut"  shaped  loss-cone  to  a "dumb-bell"  aligned  flux  form. 

NASCAP  allows  for  a table  of  R(E)  values  for  different  incident 
energies  to  be  entered.  The  code  then  automatically  takes  the 
variation  in  anisotropy  as  a function  of  energy  into  account  when 
calculating  currents. 

5.10.1.3  Current  Collection.  For  particles  incident  with  an  energy 
E,  the  incoming  current  FIN(E)  is  given  by: 

tt/2  ir/2 

FIN(E)  = F(E)  f f /a(E)+b(E)cos2(e-e0)cos2d  cosecos2ddedrf j 

*'-1r/2  *'-ir/2  ' 
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where  for  a Maxwellian 


F(E)  = 


1/2 


Integrating  gives 


FIN(E)  = F(E) 


a(E)  + 


3b(E) 

— s — 


/ cosZe^  \ 


Integrating  over  the  plasma  energy  spectrum  gives  the  observed 
incident  current  FIN.  The  emitted  current  is  more  complex  since  all 
of  the  integrals  cannot  be  performed  analytically. 

ir/2  tt/2 

FOUT(E)  = ~~p~f  f 5(B)(E) 

-ir/2  -ir/2 

2 

cose  cos  j6  de  dd 
= 2 F(E)  A(E)  «I$0(E)  +k(E) 


a(E)+b(E)cos2(e-e0)cos2<5 


2 ? 

For  secondary  electron  emission,  expanding  cos  (e-e  ) cos  d: 


k(E)  = k 1(E)  + <2^^ 


tc^E)  = -2b(E)cos(2©o)F(E)C 


Clj 

2 -Q 

CM 

CM 

T— 1 

l \ 

T\ 

~T  " e 

'V 

C2  ( 

3 *-Q  / 

1\1 

?(; 

T “ e 
Q ' 

?)J 
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where 


<s(b)  = C 


,,  /l-e-Qco56  \ -Wl-coss+lle-^056 


Q = aR  (R  is  the  range  of  electrons  of  energy  E) 


K.(E)  = sin2e„  b(E)  C 

Z 0 IT 


Cl-Ij  + C2‘I2 


The  integrals  1^  and  are  integrated  numerically  and  tabulated 
for  various  values  of  Q.  Interpolation  finds  the  value  of  each  for  an 
unknown  Q. 


By  dividing  the  values  of  FOUT(E)  so  calculated  by  the  incident 
current  normalization  ANGF(E) 


ANGF(E)  = 


= aCE)  + 


3b(E) 


2 

(cos  ert \ 


we  obtain  the  anisotropic  yield  for  secondary  emission 

_ FOUT(E) 

6 AN  ISO  ' MERIT 
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The  proton  secondary  emission  is  much  simpler  to  calculate  since 
FOUT(E)  is  independent  of  angle: 


.proton, r*  . FOUT(E)  F0UTIS0(E) 
6 AN  ISO  (E)  ’ TOFTTT  " UnSFTTl 


The  backscatter  requires  an  additional  tabulated  integral 


-logn  logn  cose 
n(»)  > n0  e 0 e 0 


—1 og^o ( E ) 

IT  '0'"'  " <T1 


FOUT(E)  = n (E)  e 


where 


ir/2  ir/2 

K ~ f f e^cose  cos*J  cos2(e_e^)  cos^  cose  <je 


-t/2  — rr/2 


where 


y = logri 


Separating  as  before: 


k = J.  + J0 
n 1 2 


= 2 cos2e 

0 

eY  | 

(V 

- 

X Y 

= sin2e  j 

n/2 

r 

ir/2 

J 

ir/2 

4/2 

y y 


eTCOsecos<S  cos4<  C0M  de  d< 


J2  is  tabulated  for  values  of  n0. 
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ANGULAR  DISTRIBUTION  (m)  AND  TIT  TOR  ELECTRONS 


i 
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Figure  5.7.  Anisotropic  flux  distribution  with  R - -0.35. 


RNGULRR  DISTRIBUTION  N)  RND  FIT  FOR  ELECTRONS 
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Figure  5.8.  Anisotropic  flux  distribution  with  R 


ANGULAR  DISTRIBUTION  (*)  AND  FIT  FOR  ELECTRONS 
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Figure  5.9.  Isotropic  flux  distribution. 


RNGULRR  DISTRIBUTION  (x)  RND  FIT  FOR  ELECTRONS 
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Figure  5.10.  Anisotropic  flux  distribution  with  R = 0.10. 


ANGULAR  DISTRIBUTION  (Ml  AND  TIT  TOR  ELECTRONS 
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Figure  5.11.  Anisotropic  flux  distribution  with  R = 0.50. 


5.10.2  TEST  TANK-6  ( ITYPE  6) 

Test  Tank-1  uses  particle  tracking  techniques  to  simulate  an 
electron  gun.  With  this  method  the  beam  electron  trajectories  are 
approximated  by  calculating  the  actual  trajectories  of  representa- 
tive beam  particles.  While,  in  principle,  enough  particles  could  be 
followed  to  make  the  results  as  accurate  as  desired,  in  practice, 
computer  time  used  to  calculate  each  representative  orbit  places 
severe  restrictions  on  the  number  of  test  particles  followed. 

Following  the  basic  philosophy  that  has  been  successful 
throughout  NASCAP  we  opted  to  use  a simplified  representation  of  the 
space  potentials  which  allows  direct  integration  of  particle  orbit. 
Particle  shadowing  is  included  in  an  approximate  manner  using  HIDCEL 
with  the  "viewer"  located  at  the  gun  position.  The  potential  is 
modeled  by  keeping  only  one  monopole  term  in  the  multipole 
expansion.  This  is  a reasonable  approximation  for  gun  to  satellite 
distance  large  compared  to  satellite  radius. 

To  implement  the  proposed  method  of  approach,  consider  a point 

source  at  a distance  rQ  from  the  center  of  force  (Figure  5.12). 

The  rate  at  which  the  source  emits  electrons  with  kinetic  energy 

E into  the  interval  dE  and  the  solid  angle  dft  is  denoted  by 
oo  o 
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d2I 


(E0,S0)  dE0  dno 


Particles  leaving  the  source  in  the  range  dE  dft  about 
^ 0 0 

(E  »«  0)  cross  a surface  element  of  area  dS  about  the  point 

-4*  ° -4*°  -V 

r = r(E0,nQ)  on  a sphere  of  radius  a with  energies  in  the  range 
dE.  In  a steady  state  particle  conservation  requires  that 

r d2I  dE.dft.  = f .t-dS  dE 

J snssr  0 0 J 

(AE0,Afl0)  0 0 (aE.aS) 

= a J j*n  dE  d fi 

(aE.a  ) 

p 

where  j is  the  current  density  per  unit  energy  at  r, Afl  = AS/a  in 

the  solid  angle  subtended  by  aS  at  the  center  of  force,  and  ft  = n = r/r 

is  the  unit  vector  normal  to  the  surface  of  the  sphere  of  radius  r 

with  center  at  the  center  of  force.  Since  aE  and  a ft  are 

o o 

arbitrary 


j.  n | = 


1 d2I  1 


where 


J = 


9 

9 


E,  ft  \ 

E ^ 
o o 
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Once  | j»n|  is  determined,  the  current  density  j per  unit  energy 
follows  from 


T ,t  | V 

J = 1 rn  | 

-+■ 

VR 

where  V = V(EQ,ft0)  is  the  velocity  at  r = r(Eo,fl). 

The  primary  problem  in  the  determination  of  j is  the  evaluation 

of  the  Jacobian.  Consider  first  the  case  of  no  magnetic  field  and  a 

repulsive  potential  V = k/r.  The  particles  follow  a hyperbolic  path 

with  the  center  of  force  at  the  focus.  The  geometry  of  the  encounter 

is  shown  in  Figure  5.13  where  we  also  introduce  the  angular  coordinate 

[18] 

e in  terms  of  which  the  orbit  is  given  by 


I = . 5*  (1  + e cose)  . 
r l2 

Here  e is  measured  from  the  symmetry  axis  of  the  orbit,  m is  the 

1/2 

particle  mass,  * = mvQ  rQ  si na  = (2mEQ)  rQ  sina  is  the 
angular  momentum,  and 

‘*[1  + 4(1  + % 

where  V = k/r  . In  the  following  we  shall  use  the  orbit  equation 
o o 

in  the  form 


cose  = — 

e 


sin2a 


+ 1 


with  x = r/r  . 
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For  the  present  problem  the  required  Jacobian  is 


J = 


9 (cosx) 

u 


where 


cosx  = -cos(e-eQ) 

= -(cose  cose,,  + sine  sine  ) 
o o 

u = COSa 

and  coseQ  is  obtained  from  the  equation  given  earlier  with  x * 1. 
We  find 


J * - — 

e 


(cose^  - sine„  ctne) 
o o 


/ 4Eo  \ 

( — - cose^  + tj-2-  u]  (cose  - sine  ctne  ) 

\ “ 0 V / 0 


with 


In  the  presence  of  a constant  magnetic  field,  B,  spherical 
symmetry  of  the  force  field  is  lost  and  the  simple  analytic 
expressions  for  the  particle  orbit  are  not  known.  The  problem 
simplifies  considerably  however  if  the  magnetic  field  is  small  in  a 
sense  that  will  become  clear  as  we  consider  the  motion  observed  in  a 
system  rotating  at  a constant  angular  velocity  u.  In  the  rotating 
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system  the  effective  force  is 


[19] 


eff 


= q 


VsxB 


- 2m(uxV  ) - mux(uxr) 

P 


where 


-►  *► 

and  V and  V are  the  velocities  of  the  particle  relative  to  the 
space  and  rotating  axes  respectively.  If  we  choose 


u 


then 


-*■  ->■ 

= qE  + mux(uxr) 

Neglecting  terms  of  second  and  higher  order  in  the  B field,  the 
equation  of  motion  in  the  rotating  system  becomes 


dV 


m 


W = qE 


Thus,  to  the  considered  degree  of  approximation,  in  the  rotating  frame 
the  effects  of  the  magnetic  field  vanish  and  to  the  rotating  observer 
the  particle  moves  in  a 1/r  potential. 

To  find  where  a given  particle  strikes  the  body  we  can  consider 
that  during  the  particle's  flight  time  the  body  rotates  with  constant 
angular  velocity  -u.  The  magnitude  of  the  rotation  requires  a 
knowledge  of  the  flight  time,  which  to  the  required  order  of  accuracy 
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is  given  by 


t = 


dr 


j»  1 


. where 


The  foregoing  expressions  have  been  programmed  to  determine 
where  a particle  of  given  initial  energy  and  direction  strike  the 
object  that  is  being  charged.  The  magnitude  of  the  current  striking 
the  body  is  calculated  as  if  there  were  no  magnetic  field.  Correc- 
tions for  the  effect  of  ^ on  the  current  striking  the  object  could  be 
made,  but  in  view  of  the  rough  nature  of  the  initial  monopole 
approximation,  such  corrections  are  not  warranted. 

5.10.3  PHYSICAL  CHARACTERISTICS  OF  TRANSPARENT  ANTENNAS 


Many  spacecraft  have,  as  a dominant  feature,  large  mesh  antennas 
which  are  largely  transparent  to  light  and  particles.  Examples  of 
such  spacecraft  include  the  ATS-6  satellite  and  the  Galileo  orbiter. 

The  mesh  must  be  conductive  (in  order  to  function  as  an  antenna),  and 
thus  may  be  either  pure  conductor  (or,  equivalently,  conductively 
coated  dielectric),  or  dielectric-coated  conductor.  The  main  effect 
of  this  structure  is  to  set  the  electrostatic  potential  over  its 
area.  However,  although  it  is  considered  transparent  as  seen  by  the 
rest  of  the  spacecraft,  it  does  intercept  some  fraction  of  the 
particles  and  light  incident  on  it,  which,  particularly  in  the 
dielectric-coated  case,  affects  the  antenna's  own  potential. 

In  NASCAP  we  consider  an  antenna  mesh  to  intercept  20  percent  of 
the  incident  fluxes.  (This  should  be  made  a RDOPT  parameter  at  some 
future  time.)  For  charging  purposes,  the  area  of  an  antenna  surface 
is  considered  to  be  the  full  surface  area.  Thus  differential  charging 

will  take  place  more  slowly  on  antenna  surfaces  than  on  solid  surfaces. 
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6.  RUN  OPTIONS 


6.1  INTRODUCTION 

NASCAP  requires  three  major  types  of  information  from  the  user. 
The  first  two,  definitions  of  the  object  and  the  plasma  environment, 
are  described  in  Chapters  3 and  5.  In  this  chapter  we  describe  the 
third  type,  the  RUN  OPTIONS,  in  detail. 

Like  the  object  and  environment  definitions,  the  run  options  are 
understood  by  NASCAP  as  keywords,  read  from  their  own  file.  The  run 
options  are  read  by  a special  module  RDOPT  from  the  options  file, 
IKEYWD.  The  default  file  number  for  IKEYND  is  26.  The  RDOPT  module 
must  always  be  the  first  module  to  be  executed  in  any  NASCAP  run.  A 
new  run  always  sets  all  the  run  options  to  their  default  values. 
Subsequent  calls  to  RDOPT  do  not  cancel  options  set  in  previous  calls 
in  the  same  run  however.  The  options  file  is  read  until  an  END  card 
or  an  end-of-file  condition  is  encountered. 

The  run  options  can  be  classified  into  six  groups  according  to 
their  functions.  These  are: 

1.  Options  that  control  the  way  the  program  proceeds. 

2.  Options  that  define  electrical  connections. 

3.  Options  that  define  features  of  the  environment. 

4.  Options  that  control  printed  output. 

5.  Options  that  control  graphical  output. 

6.  Options  that  define  logical  unit  numbers. 

The  keyword  and  parameter  syntax  for  alj[  of  the  run  options  are 
summarized  in  Table  6.1.  Tables  6. 2-6.7  classify  the  options 
according  to  the  six  functions  above.  Let  us  take  each  group  and  each 
option  in  turn  and  examine  it  in  detail. 

i 
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TABLE  6.1.  NASCAP  USER  OPTIONS 


USER  OPTIONS — FILE  26 

Supplied  in  file  26 — OPT  file.  In  this  section,  indicates  integers.  “<  >"  indicates  optional  input.  Ellipses  **...'* 
indicate  continue  on  same  line.  The  most  important  options  are  RESTART,  DELTA,  L0NGTIMES7EP.  NCYC,  and 
MESH.  Options  are  set  sequentially  as  read.  They  are  remembered  throughout  the  steps  of  a NASCAP  execution,  and 
may  be  changed  by  ROOPT  calls  at  any  time. 


SYNTAX 

MEANING 

DEFAULT 

EXAMPLE 

30-VIEW  x y z 

new  SATPLT  view 

3 default  views 

3D-VIEW  4.2  4.9  -8 

3D-VIEW  NONE 

clear  view  table 

3 default  views 

3D-VIEW  NONE 

APRT  grids# 

number  grids  potential  print 

0 

APRT  2 

BFIELD  bx  by  bz 

constant  mag  field — Weders/m2 

0. 0.  0 

BFIELD  .01  1.E-5  1.E-5 

BIAS  cond#  volts 

conductor  bias  relative  to 
conductor  1 

no  bias 

BIAS  2 -500 

CU  conda#  eondb#  farads 

mutual  conductor  capacitance 

stray  capacitance  only 

CIJ  3 4 1.E-4 

COMMENT  <anythmg> 

comment — no  effect 

none 

COMMENT  SEPT  25  CHANGES 

CONTOURS  NONE 

clear  contour  table 

no  contours 

CONTOURS  NONE 

CONTOURS  STANOARD 

3 center  cuts 

no  contours 

CONTOURS  STANDARD 

CONTOURS  cut#  ... 

< GRIDS  ng#  MOO  mod#> 

additional  contour  cut 

no  contours 

CONTOURS  Y -1  GRIDS  3 MOD  4 

CONTOURS  cut#  OFF 

clear  specific  cut 

no  contours 

CONTOURS  X 0 OFF 

CONVEX 

convex  obiect.  self-shadowing  only 

HIDCEL  must  be  called  for 
nonzero  sun  intensity 

CONVEX 

CONVERGENCE  PLOTS  ON 
CONVERGENCE  PLOTS  OFF 

potential  solver  printer  plots 

Off 

CONVERGENCE  PLOTS  ON 
CONVERGENCE  PLOTS  OFF 

DEADLINE  hhmmss# 

finish  before  time  ol  day 

none 

OEADLINE  234500 

DEBYE 

activates  Debye  screening 

no  screening 

DEBYE 

DELFAC  factor 

timestep  = timestep  • factor 

1. 

DELFAC  1.5 

DELTA  timestep 

initial  timestep  (seconds) 

1. 

DELTA  .01 

DESTINATION  dest 

plot  destination 

none 

DESTINATION  CALCOMP 

DIPOLE  MOMENT  px  py  pz  ... 

magnetic  dipole  moment  (A  - M2) 

none 

DIPOLE  MOMENT  1.E-2.  1.E-2,  0 AT 

AT  x y 2 

and  location 

0.  0.  5 

DISCHARGE  relax 

perform  discharge  analysis 

no  discharge  analysis 

DISCHARGE  .5 

EFFCON  ON 

effective  surface  conductivity 

off 

EFFCON  ON 

EFFCON  OFF 

EFFCON  OFF 

EMITTER  unit# 

activate  particle  emitter 

NOEMIT 

EMITTER  23 

END 

end  of  input  file 

none 

ENO 

FIXP  cond#  volts 

fix  conductor  potential 

conductor  floats 

FIXP  2 -3000 

FLOAT 

remove  ail  previous  FIXP  and  BIAS 

previous  status 

FLOAT 

FLOAT  cond# 

float  previously  fixed  or 
biased  conductor 

previous  status 

FLOAT  3 

IOUTER  (2) 

0— grounded  outer  boundary 
2 — monopole  outer  boundary 

2.  r e.,  iff  potentials 

IOUTER  2 
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TABLE  6.1.  NASCAP  USER  OPTIONS  (Concluded) 


SYNTAX 

LONGTIMESTEP  <dvltm> 


MATVIEW  ± (fy  cuta#  cutb# 

MATVIEW  NONE 
NCYC  steps# 

NG  grids# 

NOEMIT 

NOLONG 

NOPRINT  modulename 
NOSCALE 
NOSHEATH 
NOTIME 
N Z Zdrv# 

OFFSET  x#  y#  Z# 

POTCON  decades 
PRINT  modulename 


REPEAT  times# 

RESTART 

RIJ 

SCALE 


SECONDARY  <EMISSION>  ANGLE 

SECONDARY  <EMISSION>  NORMAL 

SHEATH 

SUNDIR  x y z 

SUNINT  inlens 

SURFACE  CORNER  x#  y#  z# 

...  <norx#  nory#  norz#> 

SURFACE  CELL  cell# 

TANKCUR  OFF 
TANKCUR  ON 

TANKTRAJ  OFF 
TANKTRAJ  ON 

TIMER 

TITLE 

TYPE  type# 

XMESH  unit 
ZTRUNCATE  zlo#  zhi# 


MEANING 

DEFAULT 

EXAMPLE 

implicil  charging, 

NOLONG 

LONGTIMESTEP  2000 

Cvollage  limit  per  timestep> 

additional  material  ptol 

6 default  plots 

MATVIEW  -Z  -5  +5 

clears  MATVIEW  table 

6 default  plots 

MATVIEW  NONE 

number  timesteps  to  run 

1 

NCYC  5 

number  computational  grids 

2 

NG  3 

turn  oil  previously  defined  emitter 

previous  status 

NOEMIT 

see  LONGTIMESTEP 

explicit  charging 

NOLONG 

see  PRINT 

no  extra  printout 

NOPRINT  POTENT 

see  SCALE 

SCALE 

NOSCALE 

see  SHEATH 

no  sheath  plot 

NOSHEATH 

see  TIMER 

no  timer 

NOTIME 

z grid  size 

33 

NZ  29 

moves  coordinate  origin 

center  of  mesh  (9,  9.  17) 

OFFSET  0 0 0 

convergence  of  potential  solver 

8 — CAPACI.  4 — TRILIN 

POTCON  3 

diagnostic  prints;  modulename 

NOPRINT 

PRINT  POTENT 

is  LIMCEL.  POTENT.  HIDCEL.  or 
OBJDEF 

plot  repetition  factor  (IGS  only) 

1 

REPEAT  3 

next  timestep—  old  problem 

new  problem 

RESTART 

Interconductor  resistance 

RIJ  1 2 3.E8 

potential  solver  scales  potential 

SCALE 

SCALE 

and  boundary  conditions 

secondary  formulation 

ANGLE 

SECONDARY  ANGLE 

secondary  lormuiation 

ANGLE 

SECONDARY  EMISSION  NORMAL 

plot  space  charge  density 

NOSHEATH 

SHEATH 

sun  direction  vector 

1.  1,  1 

SUNDIR  1,  0.  2.5 

sun  intensity 

0 

SUNINT  0.8 

surface  cell  of  interest 

none 

SURFACE  CORNER  3.  3,  2 -1.0.0 

(previous  object  definition  required) 

surface  cell  of  interest 

cell  #1 

SURFACE  CELL  541 

lank  current  contour  plots 

off 

TANKCUR  OFF 
TANKCUR  ON 

lank  particle  trajectory  plots 

off 

TANKTRAJ  OFF 
TANKTRAJ  ON 

execution  time  each  module 

NOTIHE 

TIMER 

plot  title 

NASCAP 

TITLE  P78-2 

environment  type 

2 (single  Maxwellian) 

TYPE  6 

physical  grid  spacing  (meters) 

0.1 

XMESH  .03 

truncation  of  outer  grid 

full  grid.  -16  to  +16 

ZTRUNCATE  -12  +12 
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TABLE  6.2.  RUN  OPTIONS  THAT  CONTROL  PROGRAM  PROCEDURE 


DEADLINE 

DELFAC 

DELTA 

EMITTER 

END 

LONGTIMESTEP/NOLONG 

NCYC 

POTCON 

RESTART 

SCALE/ NOSCALE /DSCALE 


TABLE  6.3.  RUN  OPTIONS  THAT  DEFINE  ELECTRICAL  CONNECTIONS 

BIAS 
Cl  J 

DISCHARGE 

EFFCON 

FIXP 

FLDCON 

FLAS HOVER 

FLOAT 

RADCON 

RIJ 
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TABLE  6.4.  RUN  OPTIONS  THAT  DEFINE  FEATURES  OF  THE  ENVIRONMENT 

AND  COMPUTATIONAL  SPACE 

BFIELD 

CONVEX 

DEBYE 

DIPOLE  MOMENT 

IOUTER 

NG 

NZ 

OFFSET 

SECONDARYEMISSION 

SUNDIR 

SUN I NT 

TANK  AXIS 

TANK  RADIUS 

TYPE 

UPDATE 

XMESH 

ZTRUNCATE 

TABLE  6.5.  RUN  OPTIONS  THAT  CONTROL  PRINTED  OUTPUT 

APRT 

CONVERGENCE  PLOTS 
PRINT 

SURFACE  AT 
SURFACE  CELL 
SURFACE  CORNER 
TIMER/NOTIMER 
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TABLE  6.6.  RUN  OPTIONS  THAT  CONTROL  GRAPHICAL  OUTPUT 

3D-VIEW 

CONTOURS 

DESTINATION 

MATVIEW 

REPEAT 

SHEATH /NOSHEATH 
TANKCUR 
TANKTRAJ 
TITLE 

TABLE  6.7.  RUN  OPTIONS  THAT  DEFINE  LOGICAL  UNIT  NUMBERS 

IAREA 

IAUN 

ICNOW 

IDIV 

I FLUX 

IKEYWD 

ILTBL 

IOBJ 

IOBPLT 

IP 

I PART 

IPQCND 

IR 

I ROUS 
I SAT 
I SPARE 
ISPCTR 
IU 
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6.2  OPTIONS  THAT  CONTROL  PROGRAM  PROCEDURES 


6.2.1  DEADLINE 

The  card: 

DEADLINE  hhmmss 

tells  NASCAP  to  finish  its  run  before  the  time  'hhmmss',  e.g. 

DEADLINE  234500 

causes  NASCAP  to  exit  cleanly  before  11:45  p.m.  (For  example,  there 
may  be  computer  hardware  maintenance  scheduled  for  midnight.)  The 
present  cycle  is  finished,  files  are  closed  and  output  is  printed. 

This  enables  the  user  to  RESTART  the  run  later.  The  default  behavior 
(i.e.,  when  no  DEADLINE  card  is  included  in  the  options  file)  is  to 
keep  running  until  all  of  the  requested  cycles  have  been  completed,  or 
until  NASCAP  determines  there  is  insufficient  run  time  left  to 
continue,  regardless  of  the  time  of  day. 

6.2.2  DELTA 

The  card: 

DELTA  d 

sets  the  length  of  each  of  the  timesteps  requested,  to  "d"  seconds, 
e.g., 

DELTA  10 

sets  the  length  to  10  seconds.  The  default  value  (if  a DELTA  card  is 
omitted  completely)  is  1 second. 

6.2.3  DELFAC 

The  card: 

DELFAC  f 

causes  the  length  of  the  computational  timestep  DELTA  to  be  increased 
by  the  factor  f at  end  of  each  cycle.  For  example  the  cards 


DELTA  10 
DEL FAC  2 

will  cause  a 10  second  timestep  for  cycle  1,  a 20  second  timestep  for 
cycle  2,  a 40  second  timestep  for  cycle  3,  and  so  on.  The  default 
value  of  DELFAC  is  1. 

6.2.4  EMITTER 

Including  the  card 
EMITTER  n 

in  the  options  file  establishes  a particle  emitter  input  file  n.  The 
default  value  of  n is  5 (the  NASCAP  runstream) . If  the  EMITTER  card 
is  found  by  RDOPT,  TRILIN  will  look  for  input  defining  one  or  more 
particle  emitters  in  file  n.  This  is  discussed  in  detail  in  Chapter 
7.  An  existing  emitter  can  be  turned  off  with  the  card 
NOEMIT 

The  default  behavior  is  to  assume  no  emitters. 

6.2.5  END 

Indicates  end  of  options  file. 

6.2.6  LONGTIMESTEP/NOLONGTIMESTEP 

The  rate  of  change  of  the  potential  V of  an  object  being  charged 
by  a net  current  I is  inversely  proportional  to  its  capacitance  C. 


dV  _ I 
clt  “ C 


A spacecraft  usually  has  a very  small  capacitance  to  infinity  compared 
with  the  capacitances  between  its  dielectric  surfaces  and  their  under- 
lying conductors.  This  leads  to  at  least  two  very  different  charging 
timescales.  For  a given  current  the  rate  of  charging  of  the  whole 
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spacecraft  with  respect  to  the  surrounding  plasma  is  typically  orders 
of  magnitude  greater  than  the  rate  of  differential  charging  between 
different  surfaces  of  the  spacecraft.  For  example  an  initially 
uncharged  satellite  exposed  to  a magnetic  substorm  at  geosynchronous 
orbit  (i.e.,  exposed  to  a charging  plasma)  might  charge  to  3 or  4 kV 
in  perhaps  0.1  seconds,  before  reaching  a quasi-equilibrium  based  on 
its  capacitance  to  infinity.  However,  over  the  next  1000  seconds 
differential  potentials  may  develop  between  the  dielectric  surfaces 
and  other  parts  of  the  spacecraft  as  these  larger  capacitances  become 
charged. 

These  widely  differing  charging  rates  make  the  choice  of 
timestep  duration  (DELTA)  a delicate  one.  If  the  timestep  is  chosen 
to  be  much  longer  than  the  charging  timescale,  wild  oscillations  about 
the  equilibrium  potential  are  likely.  If  the  timestep  is  chosen  to  be 
much  smaller  than  the  charging  timescale,  nothing  physically  inter- 
esting will  happen  until  many  timesteps  (and  much  valuable  computer 
time)  have  been  expended.  The  ideal  solution  is  to  choose  very  short 
timesteps  for  the  first  few  cycles,  when  the  satellite  is  charging 
rapidly,  and  then  to  increase  them  once  the  first  quasi-equilibrium  is 
achieved  and  differential  charging  is  occurring  on  a longer  timescale. 
This  can  be  done  explicitly  by  the  user,  or  as  an  alternative,  NASCAP 
provides  an  option  that  maintains  the  charging  rate  and  adjusts  the 
timestep  duration  internally  to  avoid  potential  overshoot  and 
oscillations:  The  card: 

LONGTIMESTEP  <dvlim> 

activates  this  option  (called  the  LONGTIMESTEP  option).  The 
LONGTIMESTEP  option  is  deactivated  by  default,  or  it  may  be  explicitly 
"turned  off"  by  the  card 

N0L0NG  (or  NOLONGTIMESTEP) 

The  parameter  <dvlim>  is  the  maximum  change  in  the  magnitude  in  volts 
of  any  conductor  potential  that  may  occur  during  a timestep.  For 
example,  consider  a surface  expected  to  reach  an  equilibrium  potential 
of  -4  kV  in  1 second,  if  dvlim  is  chosen  to  be  2000  V,  and  DELTA  is 
chosen  to  be  say  10  seconds,  then  LONGTIMESTEP  will  cut  the  length  of 
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the  timestep  back  from  DELTA  (10  s)  to  approximately  0.5  seconds,  a 
time  enough  for  the  surface  to  reach  -2  kV  and  no  more.  Equilibrium 
will  not  be  reached  until  the  second  cycle. 

If  dvlim  had  been  chosen  to  be  1000  V then  equilibrium  would  be 
reached  in  approximately  4 cycles  with  duration  of  around  0.25 
seconds,  and  so  on.  The  smaller  dvlim  is  chosen  to  be  the  more 
timesteps  NASCAP  will  take  to  reach  equilibrium  and  the  better 
resolved  will  be  the  transient  charging  response  of  the  satellite. 

The  default  value  of  dvlim  is  1000  V. 

If  dvlim  is  chosen  to  be  too  large  (i.e.,  greater  than  the 
expected  quasi-equilibrium  potential)  and  DELTA  is  chosen  to  be  longer 
than  the  active  charging  timescale  then  oscillations  in  the  potential 
may  still  occur. 

The  advantage  of  the  LONGTIMESTEP  option  is  that  it  allows 
timesteps  appropriate  to  the  phenomena  of  interest.  For  example,  a 
user  interested  only  in  the  final  steady-state  potentials  can  cover 
the  transient  response  with  relatively  few  timesteps.  These  arguments 
apply  of  course  to  charging  and  discharging  equally  well.  It  is 
generally  recommended  that  most  users  use  the  LONGTIMESTEP  option  most 
of  the  time. 

6.2.7  NCYC 

The  card: 

NCYC  * 

sets  the  number  of  charging  cycles  for  the  TRILIN  module.  If  no  card 
is  included  in  the  options  file  NCYC  is  assumed  to  be  1.  Any 
(integral)  number  of  cycles  may  be  requested  but  it  is  a good  practice 
to  break  a long  simulation  up  into  a number  of  runs  of  perhaps  5 or  10 
cycles  at  most.  This  enables  the  user  to  more  closely  monitor  the 
results  and  to  adjust  DELTA,  <dvlim>  (6.2.2  and  6.2.6)  and  other 
parameters  where  necessary. 
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6.2.8 


POTCON 


The  card 

POTCON  n 

says  that  n orders  of  magnitude  convergence  are  required  of  the  Scaled 
Conjugate  Gradient  potential  solver.  If  not  set  in  the  options  file, 
it  will  be  set  to  8 by  CAPACI,  or  to  6 by  IPS,  or  to  4 by  TRILIN. 

These  defaults  have  been  found  to  be  a good  compromise  between 
accurate  electric  field  determinations  (i.e.,  more  convergence)  and 
fast  run  times  (i.e.,  less  convergence). 

6.2.9  RESTART 

Including  the  card 
RESTART 

in  the  options  file  causes  NASCAP  to  continue  a previous  run.  For 
example,  if  5 cycles  were  requested  for  a new  NASCAP  run  and  all  the 
restart  files  were  saved  (2.7)  a subsequent  run  with  the  same  object, 
etc.  would,  by  default,  start  with  cycle  1 and  the  potentials  all  at 
zero;  i.e.,  the  first  5 cycles  would  be  repeated.  If,  however,  a 
’RESTART'  card  is  included  in  the  options  file  of  the  second  run, 
potential  calculations  will  begin  with  cycle  6 and  the  first  run  will 
be  continued  - just  as  if  more  than  5 cycles  had  been  originally 
requested.  This  enables  the  user  to  break  up  a long  (many  cycle) 
charging  simulation  into  a number  of  smaller,  more  manageable  runs. 

A run  cannot  be  restarted  unless  the  restart  files  discussed  in 
Section  2.7,  saved  from  the  previous  run,  are  assigned  to  the  restart 
file  numbers.  In  other  words  the  restarted  run  must  be  able  to  access 
the  information  stored  in  the  restart  files. 


6.2.10  SCALE /NOSCALE /DSCALE 


The  potentials  in  the  space  surrounding  the  object  are 
determined  iteratively  from  the  potentials  remembered  from  the 
previous  timestep  [Section  3.15.1]  (=0  for  the  first  timestep).  The 
further  away  the  initial  potentials  are  from  their  iterative  solution 
more  iterations  are  required  to  achieve  convergence.  To  a zeroth 
approximation  the  potentials  in  free  space  are  proportional  to  the 
total  amount  of  charge  collected  by  the  object.  Hence  a better 
starting  point  for  the  initial  potentials  in  each  timestep  is  given  by 
scaling  the  values  from  the  previous  timestep  as  follows: 

Total  charge  collected  up  to  and 

including  timestep  n 

Total  charge  collected  up  to  and 
including  timestep  n - 1 

final  potentials  for  timestep  n - 1 

For  a floating  spacecraft  this  is  automatically  carried  out  by 
default,  or  by  including  the  card 
SCALE 

Scaling  is  turned  off  if  conductor  1 is  at  fixed  potential,  or  if  the 
card 

NOSCALE 

is  encountered.  The  DSCALE  option  counts  only  charge  on  dielectric 
surfaces  and  is  appropriate  to  a grounded  object  (i.e.,  in  a test 
tank).  The  user  need  rarely  specify  any  of  these  options,  as  NASCAP 
defaults  are  almost  always  adequate. 


Initial  guess  for 
potentials  in  timestep  n = 


x 
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6.3  RUN  OPTIONS  THAT  DEFINE  ELECTRICAL  CONNECTIONS 


6.3.1  BIAS 

The  card: 

BIAS  i v 

causes  conductor  i to  be  biased  by  v volts  relative  to  conductor  1. 
Conductor  1 is  usually  the  spacecraft  ground.  For  example  the  card 
BIAS  3 -1000 

causes  conductor  3 to  always  be  1000  volts  more  negative  than 
conductor  1.  If  conductor  1 were  floating  at  -300  V then  conductor  3 
would  have  a potential  of  -1300  V.  The  BIAS  cards  for  each  conductor 
must  be  entered  in  ascending  order.  Thus  any  card  for  conductor  3 
will  be  rejected  unless  conductor  2 has  been  biased.  Cards  need  only 
be  included  for  those  conductors  that  the  user  wants  to  be  biased. 

The  default  behavior  for  a conductor  not  biased  or  fixed  (see  FIXP)  is 
to  float  independently. 

6.3.2  CIJ 

There  are  two  sources  of  capacitance  between  conductors.  The 
stray  capacitances  are  determined  by  the  throughspace  electric  fields 
and  geometrical  relationships  between  conductors  and  are  calculated  by 
NASCAP  automatically.  However,  the  larger  capacitances  due  to  conduc- 
tors being  glued  together  or  separated  by  dielectric  films  must  be 
specified  by  the  user.  The  card: 

CIJ  k 1 c 

sets  this  "mechanical  connection"  capacitance  between  conductor  number 
k and  1 to  c farads.  For  example  the  card: 

CIJ  2 3 l.E-8 

sets  the  "mechanical"  capacitance  between  conductor  2 and  3 to 
“8 

1 x 10  farads.  This  value  is  then  added  as  a parallel  capacitance 
to  the  stray  capacitance  already  calculated  by  NASCAP. 
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The  mechanical  value  usually  dominates  the  stray  value.  Failure 
to  define  the  mechanical  value  may  cause  differential  charging  between 
the  two  conductors  in  question  to  occur  unrealistically  fast. 

When  multiple  definitions  of  capacitances  are  made  NASCAP 
includes  implicit  as  well  as  explicit 'connections  in  its  calculation. 
For  example 

CIJ  1 2 l.E-3 

CIJ  1 3 2.E-3 

CIJ  2 3 3.E-4 

defines  explicit  capacitive  connections  between  conductors  1 and  2, 

1 and  3 and  2 and  3.  However,  1 is  also  connected  to  3 via  2,  and  so 
on.  The  circuit  diagram  used  by  NASCAP  has  the  form: 


Conductor  3 


Conductor  2 


Conductor  1 


Stray  capacitances  are  calculated  only  between  the  ground  conductor 
(1)  and  each  of  the  other  14.  Stray  capacitance  between  conductors  2 
and  3,  3 and  4,  etc.  are  assumed  negligible. 

6.3.3  DISCHARGE 

A discharge  analysis,  to  take  place  in  the  LIMCEL  (LONGTIMESTEP) 
phase  of  a TRILIN  timestep,  may  be  requested  by  the  RDOPT  input  card 
DISCHARGE  d 

where  d is  a real  number,  0 < d < 1.  This  will  result  in  the  default 
discharge  analysis,  i.e.,  all  four  types  of  discharges  may  take  place 
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through  all  space,  and  all  materials  will  have  d as  a relaxation 
factor.  Figure  6.1  shows  an  example  of  the  default  discharge 
parameter  specification. 

The  discharge  analysis  takes  place  in  the  order  (1)  blowoffs, 

(2)  discharges  to  space  (determined  by  material  property  15),  (3) 
punchthroughs  (determined  by  material  property  16)  and  (4) 
flashovers.  Only  one  blowoff  or  discharge  to  space  is  allowed  per 
timestep.  However,  the  punchthrough-f lashover  routine  will  be  called 
repeatedly  until  all  allowed  punchthrough  or  f lashover  discharges  have 
taken  place. 

6. 3. 3.1  The  BLOWOFF  Discharge.  The  BLOWOFF  discharge  is  a new  type 
of  discharge  incorporated  into  NASCAP  because  it  is  believed  to  be  a 
common  type  of  small  discharge  occurring  on  spacecraft,  and  having  a 
relatively  low  threshold  voltage.  The  discharge  occurs  on  a surface 
which  is  primarily  insulating,  but  has  some  exposed  conductor.  When 
the  insulator  is  sufficiently  positive  relative  to  the  conductor, 
electrons  will  be  accelerated  outward  from  the  conductor  sufficient  to 
raise  the  conductor  potential  to  near  plasma  ground.  Also,  sufficient 
electrons  will  land  on  nearby  insulator  to  partially  discharge  it,  and 
electrons  will  also  land  on  distant  portions  of  the  spacecraft. 

6.3.3. 2 Discharge  to  Space.  Material  property  15  (4.3.10)  contains 
the  maximum  negative  potential  in  volts  that  any  surface  covered  with 
that  material  can  reach  before  charge  is  blown  off  into  space.  On 
entering  the  discharge  analysis,  NASCAP  searches  for  all  surface  cells 
with  potentials  more  negative  than  their  property  15  value.  The  ratio 
of  their  potential  to  property  15  defines  the  severity  of  the 
discharge. 

potential  of  cell  . 

Severity  of  discharge  for  cell  , = propert>  1$  of  ce11  . 
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DISCHARGE  .6 
END 


(a)  RDOPT  input  for  example  1 (default  options). 


DISCHARGE  .6 
END 


(b)  RDOPT  output  for  example  1 (default  options). 


OISCHAR6E  PARAMETERS: 


DISCHARGE  REGION; 


1<X< 

I<»< 

1<2< 


17 

17 

33 


0ISCHAR6E 

CATEGORIES 

: BLOMOFF-  YES 

TO  SPACE  - YES 

PUNCHTHR0U6H  YES 

FLASHOWER  - VES 

CONDUCTORS 

: 

1-YES  2-YES  3-YES 

4-TES 

5-TES 

6-YES  7-YES  B-YES 

9-TES 

10-TCS 

11-YES  12-YES  13-YES 

14-TES 

15-tES 

MATERIAL 

RELAX 

BLOWOFF 

ALUM 

• 400 

1.0*005 

MAPI 

• 400 

1.0*005 

TEFL 

• 400 

1.0*005 

60L0 

• 600 

1.0*005 

SOLA 

• 600 

1.0*005 

(c)  LIMCEL  output  for  example  1 (default  options). 


Figure  6.1.  Discharge  specification  example  1 (default  options). 
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Starting  with  the  most  severe  discharge  the  potential  on  the  cell  is 
reduced  to  (1  - d)  times  its  property  15  value.  The  charge  lost  is 
assumed  blown  off  into  space.  Recall  that  the  parameter  "d"  is 
included  as  part  of  the  'DISCHARGE'  card.  It  gives  the  fraction  of 
the  potential  on  the  surface  cell  that  is  lost  during  the  discharge 
(0.1  < d < 1.0). 

6.3.3. 3 Punchthrough  Discharges.  The  second  stage  of  the  analysis 
is  to  search  for  the  surface  cells  with  the  most  severe  "punchthrough" 
possibilities.  A "punchthrough"  occurs  when  the  potential  difference 
between  a dielectric  surface  and  its  underlying  conductor  exceeds  the 
value  stored  by  material  property  16.  The  severity  of  a punchthrough 
is  given  by  the  ratio  of  the  potential  difference  to  property  16.  The 
punchthrough  reduces  the  surface  potential  to  ( 1— d ) times  its  property 
16  value.  The  charge  is  partially  blown  off  and  partially 
redistributed  to  the  conductor  and  other  surfaces.  After  each 
punchthrough  analysis  and  each  charge  redistribution,  the  cells  are 
searched  again  for  the  most  severe  punchthrough  condition  and  the 
analysis  repeated.  This  continues  until  all  punchthroughs  are 
resolved. 

6. 3. 3. 4 FLASHOVER  Discharges.  Finally  different  potentials  between 
neighboring  surface  cells  are  scanned  for  those  that  exceed  the 
FLASHOVER  threshold.  This  is  10,000  volts  by  default.  It  may  be 
adjusted  by  including  the  card 

'FLASHOVER  f' 

in  the  options  file,  where  f is  the  threshold  in  volts.  The  potential 
difference  is  reduced  to  (1-d)  of  the  value  f and  charge  is 
redistributed  to  more  positive  surface  cells.  (See  also  Section 
6.3.7.) 

6. 3. 3. 5 Revising  the  DISCHARGE  Specifications.  To  revise  the 
discharge  parameter  specification,  use  the  card 

DISCHARGE  d lun 

where  d is  a real  number  as  above,  and  lun  is  the  logical  unit  from 
which  discharge  specifications  are  to  be  read.  If  lun  is  specified  as 
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less  than  or  equal  to  zero,  specifications  will  be  read  from  the  same 
options  file  from  which  the  DISCHARGE  card  was  read. 

6. 3. 3. 5.1  The  RESTRICT  Command.  RESTRICT  is  used  to  limit  discharges 
either  to  a particular  region  of  space,  in  which  case  it  takes  the  form 

RESTRICT  xmin  xmax  ymin  ymax  zmin  zmax 
where  xmin,  etc.  are  integers,  or  to  a particular  conductor,  by  the 
form 

RESTRICT  CONDUCTOR  n 

The  meaning  of  the  space  restriction  is  that  only  surface  cells  whose 
associated  volume  cells  (as  denoted  by  their  low-indexed  corner)  lie 
within  the  region  are  considered  as  discharge  candidates.  The  space 
restriction  does  not  apply  to  discharges  occurring  on  booms. 

6. 3. 3. 5. 2 The  IGNORE  Command.  The  IGNORE  command  is  used  to  instruct 
NASCAP  to  neglect  possible  discharges  of  a particular  type,  on  a 
particular  conductor,  or  on  a particular  material.  The  possible  forms 
are 

IGNORE  BLOWOFF 
IGNORE  SPACE 
IGNORE  PUNCHTHROUGH 
IGNORE  FLASHOVER 
IGNORE  CONDUCTOR  n 
IGNORE  matl 

6. 3. 3. 5. 3 Material  Commands.  Material  commands  are  used  to  set  the 
BLOWOFF  threshold  or  the  relaxation  factor  for  individual  materials. 
Possible  forms  are 

matl  IGNORE 
matl  x bt 
matl  bt  x 
matl  x 
matl  bt 

where  bt  is  the  blowoff  threshold  (volts,  bt  > 1)  and  x is  the 
relaxation  factor  (0  < x < 1).  If  x is  specified  but  not  bt,  bt  will 
be  set  to  100,000  volts.  If  bt  is  specified  but  not  x,  x will  be  set 
to  one-half. 


213-4 


6. 3. 3. 5. 4 The  END  Command.  The  END  command  says  to  ignore  subsequent 
cards  (if  in  a separate  file,  in  which  case  an  EOF  condition  will 
accomplish  the  same  thing)  or  to  return  to  normal  option  reading  (if 
in  the  OPTION  file) . 

6. 3. 3. 5. 5 The  FLASHOVER  Option.  FLASHOVER  continues  to  be  a regular 
option  read  by  RDOPT,  and  having  the  form 

FLASHOVER  volts 

Material-dependent  thresholds  are  not  implemented,  but  the  region  and 
conductor  restrictions  will  apply.  The  relaxation  factor  will  be  that 
specified  in  the  DISCHARGE  option  card.  The  default  flashover 
threshold  is  10,000  volts. 

6. 3. 3. 5. 6 Example.  The  following  example  (Figure  6.2)  illustrates 
specification  of  discharge  options.  Five  materials  (ALUM,  KAPT,  TEFL, 
GOLD,  and  SOLA)  have  been  defined.  (The  default  options  were  shown 
above  in  Figure  6.2.) 
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0I.SCHAR6E  .7  5 
IGNORE  PUNCH THROUGH 
IGNORE  SPACE 
RESTRICT  CONOUCTOR  2 
KAPTON  .8 
TEFLON  2500 
SOLAR  2800  .8 
NPAINT  .9  9000 
ENO 
ENO 

(a)  RDOPT  input  for  example  3. 


KETUORO  INPUT 
DISCHARGE  .7  5 
IGNORE  PUNCHTHROUGH 
IGNORE  SPACE 
RESTRICT  CONOUCTOR  2 
KAPTON  .8 
TEFLON  2500 
SOLAR  2800  .9 
NPAINT  .9  9000 
ENO 

0ISCHAR6E  OPTION  SUNHARV 

REGION  RESTRICTION:  1<X<  17 

1<T<  17 

1<Z<  33 


COMO-  I 

MO 

CONO- 

2 

US 

CONO-  3 

MO 

CONO-  0 

NO 

CONO-  5 

NO 

COMO-  6 

MO 

CONO- 

7 

MO 

CONO-  8 

NO 

COMO-  9 

NO 

CONO-  ! 0 

NO 

CO NO* 11 

MO 

COND- 

12 

MO 

CONO-13 

NO 

C0N0-1N 

NO 

CONO- 1 5 

NO 

ENO 


BLOWOFF  ONLY  - TES 

TO  SPACE  - NO 

PUNCHTHROUGH  - NO 

FLASHQVER  - YES 


KAPT 

FRAC- 

•00 

BLOHOFF 

AT 

1.00*005V0LTS 

TEFL 

FRACr 

•so 

BLOWOFF 

AT 

2.50*00 3V0LTS 

SOLA 

FRAC2 

• NO 

BLOWOFF 

AT 

2.80*003 VOLTS 

NPAl 

frac= 

• 90 

BLOHOFF 

AT 

9.0Q*003V0LTS 

(b)  RDOPT  output  for  example  3. 


***W4RNIN6««*  01SFIL  - MATERIAL  NPAI  NOT  FOUNO. 
DISCHARGE  PARAMETERS: 


01SCHAR6E 

REGIONS  1<X< 

17 

KT< 

17 

1<2< 

33 

DISCHARGE 

CATEGORIES: 

BLOUOFF- 

res 

TO  SPACE  - NO 

PUNCH THR0U6M  NO 

FLASHOVER  - YES 


CONDUCTORS: 

1-NO 

2-TES 

3 -NO 

N -NO 

S-MO 

6-NO 

7-MO 

B-NO 

9-NO 

10-N0 

11-NO 

12-NO 

13-NO 

IN  -NO 

15-NO 

material 

RELAX 

BLOWOFF 

ALUM 

.700 

1.0*00S 

KAPT 

.800 

1.0*005 

TEFL 

.500 

2.5*003 

60LO 

.700 

1.0*005 

SOLA 

.900 

2.8*003 

(c)  LIMCEL  output  for  example  3. 

Figure  6.2.  Discharge  specification  example  3. 
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6.3.4 


EFFCON 


The  card: 

EFFCON  ON 

activates  the  photosheath  contribution  to  the  surface  conductivity. 

The  intrinsic  surface  conductivity,  (material  property  14  (4.3.9)) 
due  to  the  properties  of  the  surface  material  itself,  is  automatically 
included  in  current  calculations.  An  additional  contribution  may 
arise  when  a dielectric  surface  emits  photoelectrons  and  their  escape 
is  inhibited  by  a positive  electric  field.  The  trajectory  of  the 
emitted  electron  then  no  longer  extends  to  infinity  but  instead  is 
turned  around  and  the  electron  returns  to  another  neighboring  surface 
cell.  The  magnitude  of  this  so-called  "photosheath"  conductivity 
depends  on  the  emitted  current  and  the  normal  and  transverse  electric 
fields. 

The  default  operation  (and  the  card) 

EFFCON  OFF 

cause  the  photosheath  conductivity  to  be  omitted  from  NASCAP  current 
calculations.  Including  the  effect  can  cause  oscillations  in  surface 
cell  potentials  from  cycle  to  cycle.  This  undesirable  result  can 
often  be  controlled  by  reducing  DELTA  (6.2.2)  and/or  dvlim  (6.2.5). 
Persistent  oscillation  can  sometimes  only  be  overcome  however  by 
abandoning  the  use  of  the  EFFCON  option.  In  general  'EFFCON  ON' 
should  only  be  used  when  absolutely  necessary,  and  then  with  care. 

6.3.5  FIXP 

The  card: 

FIXP  n v 

fixes  the  potential  of  conductor  #n  to  v volts.  For  example 
FIXP  4 -6000 

sets  conductor  4 to  a potential  of  -6000  volts,  where  it  remains, 
fixed  for  all  future  potential  calculations.  The  most  common  use  of 
this  option  is  to  ground  conductor  1 in  a test  tank: 
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FIXP  1 0. 

The  default  behavior  is  for  all  conductors  to  float  freely.  (See 
BIAS,  6.3.1.) 

6.3.6  FLDCON 

The  card: 

FLDCON  ON 

activates  the  field-induced  contribution  to  the  bulk  conductivity. 

The  default  behavior  is  to  omit  this  contribution.  The  card: 

FLDCON  OFF 

does  this  explicitly.  The  field-induced  contribution  to  the  bulk 
conductivity  is  discussed  in  detail  in  Chapter  4 (4.8.5). 

6.3.7  FLASHOVER 

The  card: 

FLASHOVER  f 

sets  the  potential  difference  threshold  for  flashover  between  two 
charged  surfaces  to  f volts.  For  example 
FLASHOVER  5000 

sets  the  threshold  to  5000  volts.  The  default  value  is  10,000  volts. 
Flashover  analysis  is  described  in  Section  6.3.3. 

6.3.8  FLOAT 

The  card: 

FLOAT  <cond  # > 

removes  the  effect  of  all  previous  BIAS'S  and  FIXP's  affecting  the 
specified  conductor  number.  For  example 
FLOAT  4 

allows  a previously  biased  or  fixed  conductor  4 to  float  freely 
again.  This  is  necessary  because  options  FIXP  and  BIAS  are  remembered 
from  previous  calls  to  RDOPT  within  the  same  run.  The  card: 

FLOAT 

with  no  "cond#  " causes  all  previous  FIXP  and  BIAS  commands  to  be 
cancelled  for  ^1J_  conductors;  i.e.,  all  conductors  float  freely. 
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6.3.9 


RADCON 


The  card: 

RADCON  ON 

activates  the  radiation-induced  contribution  to  the  bulk  conductivity 
for  dielectrics.  The  default  behavior  is  to  omit  this  contribution. 
Omission  may  be  specified  explicitly  with  the  card 
RADCON  OFF 

The  radiation-induced  conductivity  is  discussed  in  detail  in  Section 
4.8.5. 

6.3.10  RIJ 

NASCAP/GEO  now  has  the  capability  of  treating  explicitly 
specified  conduction  among  the  various  conducting  segments.  Inter- 
conductor resistances  are  specified  in  the  RDOPT  module  in  a similar 
manner  to  interconductor  capacitances  by  the  card 
RIJ  i j r 

where  i,  j are  conductor  indices,  and  r is  the  direct  interconductor 
resistance  in  ohms.  Resistances  less  than  lfl  will  be  ignored  (i.e., 
considered  infinite). 

The  RIJ  and  CIJ  keywords  differ  in  that,  while  the  CIJ  values 
have  instantaneous  effect,  changes  in  interconductor  resistance  (RIJ) 
take  effect  only  upon  subsequent  call  to  OBJDEF  or  NEWMAT.  Like  the 
CIJ  values,  all  RIJ's  are  defaulted  to  zero  (i.e.,  zero  conductivity 
or  infinite  resistivity)  at  the  beginning  of  each  NASCAP  execution, 
and  values  are  remembered  until  exit  from  NASCAP.  However, 
resistivity  values  processed  by  OBJDEF  or  NEWMAT,  which  are  the  only 
values  used  in  actual  computation,  are  remembered  from  run  to  run. 

Use  of  very  low  resistivities  to  effectively  short  two 
conductors  together  is  not  recommended. 
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6.4  RUN  OPTIONS  THAT  DEFINE  FEATURES  OF  THE  ENVIRONMENT  AND 
COMPUTATIONAL  SPACE 

6.4.1  BFIELD 

The  card: 

BFIELD  Bv  B B 
x y z 

sets  the  magnetic  field  vector  in  the  vicinity  of  the  satellite  to 

B , B , B where  the  Cartesian  components  B , B , B are 
x y z _2  r x y z 

all  in  Webers  m . The  default  is  no  magnetic  field;  i.e., 

BFIELD  000 

For  example,  the  card: 

BFIELD  l.E-5  l.E-5  0. 

describes  a field  pointing  between  the  positive  X and  Y axes  in  the  XY 
plane  with  magnitude  S2  x 10~5  W m“2  (0.14  gauss). 

The  module  ROTATE  rotates  the  magnetic  field  direction  as  well 
as  the  sun  direction  with  respect  to  the  satellite  (8.2). 

6.4.2  CONVEX 

The  card: 

CONVEX 

causes  the  shadowing  of  surface  cells  from  sunlight  to  be  calculated 
on  the  basis  of  simple  self- shadowing  only  - without  calls  to  HIDCEL 
(8.1).  Self-shadowing  assumes  that  illumination  depends  only  on  the 
angle  between  the  surface  normal  of  a cell  and  the  sun  direction  e. 
degree  of  illumination  “cose. 

The  default  behavior  is  to  demand  a call  to  HIDCEL  to  determine  cell 
shadowing. 

6.4.3  DEBYE 

The  card: 

DEBYE 

activates  the  Debye  screening  option.  The  default  behavior  is  to 
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assume  that  the  space  around  the  object  has  zero  charge  density.  This 
is  a good  approximation  for  environments  with  a Debye  length  x much 
greater  than  a mesh  unit  XMESH  (6.4.15).  The  Debye  length  is  defined 
for  Maxwellian  environments  as 


1/2 


where  e is  the  plasma  temperature  (eV)  and  n is  the  density 


(m'3). 


or  for  a double  Maxwellian  with  components  1 and  2: 


1 1 + 1 

T ■ “7 

X X1  X2 


The  Debye  screening  option  assumes  a charge  density  p linear  in  the 
potential  i>: 


This  is  a good  approximation  when  the  Debye*  length  x is  between  about 
2 and  20  mesh  units,  and  the  potential  is  at  most  comparable  to  the 
temperature.  It  can  only  be  used  with  single  or  double  Maxwellian 
plasma  spectra  (Chapter  5.4). 

When  the  DEBYE  option  is  specified,  CAPACI  (8.5)  must  be 
executed  subsequently,  before  any  new  calls  to  TRILIN,  since 
space-charge  affects  the  capacitance  of  the  object  to  infinity. 

CAPACI  reads  the  flux  definition  file  in  this  case. 

For  environments  with  x less  than  about  2 mesh  units  spatial 
oscillations  of  the  potential  are  likely  to  occur.  NASCAP  is  not 
designed  for  this  physical  regime  and  should  not  be  used  in  these 
circumstances. 
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6.4.4 


DIPOLE  MOMENT 


The  card: 

DIPOLE  MOMENT  p p p ATxyz 
x y z 

defines  a magnetic  dipole  with  moment  components  p , p and  p_ 

2 x y z 

in  A-m  located  at  grid  point  x y z.  For  example  the  card: 

DIPOLE  MOMENT  0.01  0.0  0.01  AT  5 1 2 
defines  a moment  pointing  between  the  X and  Z axes  in  the  XZ  plane 
centered  at  grid  point  512.  The  default  is  no  magnetic  dipoles 
present. 

Definition  of  dipole  moments  is  an  additional  way  of  specifying 
the  magnetic  field  on  the  satellite.  (See  BFIELD,  6.4.1).  The 
magnetic  dipoles  are  usually  derived  from  part  of  the  satellite. 

6.4.5  I OUTER 

The  parameter  I0UTER  controls  the  boundary  conditions  and  may 
take  one  of  two  values.  The  card: 

IOUTER  0 

sets  the  potentials  on  the  boundary  of  the  computational  space  to 
zero.  This  so-called  "grounded"  outer  boundary  condition  is  usually 
used  for  TEST  TANK  runs. 

The  default  behavior  and  the  card: 

IOUTER  2 

activate  "monopole"  outer  boundary  conditions  where  the  boundary 
potentials  are  set  to  be  proportionate  to  1/r  (where  r is  the  distance 
from  the  mesh  center).  The  default  IOUTER  = 2 is  usually  used  for 
space  environment  cases. 
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6.4.6 


OFFSET 


The  card: 

OFFSET  x y z 

changes  the  origin  of  the  coordinate  system  from  the  center  of  the 
mesh  to  9-x,  9-y,  17-7  (for  nz  = 33).  This  works  in  exactly  the  same 
way  in  the  options  file  as  the  command  'OFFSET'  described  in  Section 
3.9.3  works  in  the  object  definition  file. 

6.4.7  NG 

The  card: 

NG  n 

sets  the  number  of  nested  grids  in  the  computational  space  to  be  n. 

The  nesting  of  grids  is  explained  in  Section  3.2.  While  there  is  no 
theoretical  limit  on  the  number  of  grids  n,  practical  considerations 
of  storage  space  and  execution  time  suggest  n = 5 as  an  effective 
extreme  upper  limit.  The  default  value  of  n is  2.  One  grid  may  be 
used  if  the  object  does  not  occupy  most  of  it  (i.e.,  the  object  on  one 
grid  is  surrounded  by  an  excess  of  empty  space)  and  its  differential 
potential  does  not  become  very  large.  Too  little  computational  space 
causes  poor  representation  of  electrostatic  fields  and  barrier 
effects,  but  gives  greatly  enhanced  execution  speed. 

6.4.8  NZ 

The  card: 

NZ  4n  + 1 

sets  the  number  of  mesh  units  in  the  Z direction  for  all  grids  to 
4n  + 1;  i.e.,  allowable  values  are  17,  21,  25,  29,  33.  Thirty-three 
is  the  maximum  value,  and  the  value  by  default.  The  dimensions  of  the 
grids  in  the  X and  Y directions  are  fixed  at  17.  For  example  the  card 
NZ  17 

sets  the  number  of  mesh  units  in  the  Z direction  to  17. 
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6.4.9 


SECONDARYEMISSION 


By  default,  and  explicitly  with  the  card: 

SECONDARYEMISSION  ANGLE 

NASCAP  calculates  the  secondary  emission  yield  a as  a function  of 
angle  and  integrates  6(e)  over  an  appropriate  incident  flux 
distribution  f(e)  to  obtain  the  overall  yield  a. 


The  card: 

SECONDARYEMISSION  NORMAL 

causes  6(e)  to  be  set  to  6(0),  the  value  for  normal  incidence  while 
the  incident  flux  is  still  treated  as  isotropic,  i.e.. 


Since  the  yield  is  at  a minimum  for  normal  incidence  this  has  the 
effect  of  suppressing  the  positive  current,  and  effectively  leads  to  a 
more  "charging"  environment  (see  4.1). 

The  ANGLE  secondary  formulation  is  the  physically  correct  one 
and  should  be  used  for  all  realistic  charging  simulations. 

6.4.10  SUNDIR 

The  card: 

SUNDIR  x y z 

sets  the  direction  from  the  spacecraft  toward  the  sun.  The  magnitude 
is  not  relevant.  For  example 
SUNDIR  2.0  2.0  0. 

sets  the  direction  of  the  sun  between  the  positive  X and  Y axes  on  the 
XY  plane.  The  default  value  is  1,  1,  1.  The  sun  direction  need  only 
be  defined  when  the  object  is  to  be  sunlit. 
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6.4.11 


SUNINT 


The  card: 

SUNINT  intens 

sets  the  sun  intensity  as  a fraction  or  multiple  of  the  natural  sun 
intensity  one  earth  distance  from  the  sun.  For  any  earth  orbit 
exposed  to  the  sun  this  should  be  1.0,  since  orbit  altitudes  are 
negligible  compared  with  the  distance  from  the  earth  to  the  sun.  Sun 
intensities  differing  from  1.0  (and  0.0)  are  used  mainly  for 
simulations  of  test  tank  experiments  using  artificial  UV  sources,  or 
for  interplanetary  spacecraft.  For  example 
SUNINT  0.6 

sets  the  sun  intensity  to  0.6  times  its  natural  earth  value. 

The  default  value  is  0.0.;  i.e.,  the  sun  is  "turned  off"  and  the 
object  is  in  shadow. 

6.4.12  TANK  RADIUS  AND  TANK  AXIS 

The  card: 

TANK  RAOIUS  x <METERS> 

defines  a cylindrical  test  tank  environment  with  radius  x mesh  units 
or  meters.  If  the  word  "METERS"  is  explicitly  included  on  the  card 
RDOPT  assumes  that  x is  in  meters.  If  "METERS"  is  absent  it  assumes 
that  x is  in  mesh  units. 

The  orientation  of  the  tank  by  default  is  with  its  cylindrical 
axis  along  the  Z direction.  The  other  two  axis  directions  may  be 
chosen  as  the  axis  by  including  a card  of  the  form: 

TANK  AXIS  a 
where  a is  X Y or  Z 

The  height  of  the  cylindrical  tank  is  given  by  the  dimensions  of 
the  computational  space  in  the  axis  direction.  For  example  if  Z is 
the  direction  of  the  tank  axis  and  NZ  (6.4.8)  is  chosen  to  be  25,  and 
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the  number  of  grids  (NG)  (6.4.7)  is  chosen  to  be  2,  then  the  cylinder 
will  be  25  outer  mesh  units  long  or  25x2xXMESH  meters  (see  6.4.15  for 
XMESH) . The  cylindrical  tank  is  compatible  with  the  ZTRUNCATE  option. 

The  circular  cross-section  of  the  cylinder  may  lie  outside  the 
computational  space,  but  this  leads  to  its  truncation  (Figure  6.3), 
eventually  becoming  rectangular  once  more. 

Specification  of  a cylindrical  tank  automatically  sets  IOUTER 
(6.4.5)  to  0.  In  potential  contour  plots  the  tank  walls  are 
represented  by  a double  (blue)  line. 

6.4.13  TYPE 

The  cards 

TYPE  6 or  TYPE  1 

are  used  to  specify  a TEST  TANK  environment,  and  must  be  included  in 
the  options  file  when  using  the  TANK  module  (5.9).  The  TYPE  must  be 
specified  as  2 or  3 when  using  the  DETECT  module,  and  2 or  4 when 
using  the  DEBYE  option. 

6.4.14  UPDATE 

The  card: 

UPDATE  ON 

activates  the  UPDATE  feature.  UPDATE  allows  NASCAP  to  automatically 
select  the  most  recent  environment,  from  a list  provided  by  the  user, 
as  the  time  elapses  from  cycle  to  cycle.  This  is  explained  in  detail 
in  Section  5.6.  The  default  behavior  is  to  operate  without  the  UPDATE 
feature  activated.  The  same  effect  is  brought  about  with  the  card: 
UPDATE  OFF 

6.4.15  XMESH 

The  card: 

XMESH  n 

sets  the  size  of  one  inner  mesh  unit  (see  Section  3.2)  to  n meters. 
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Figure  6.3.  Cross-section  of  a cylindrical  tank  compared  with 
the  computational  space. 


For  example 


XMESH  0.2 

sets  the  inner  mesh  unit  to  0.2  m.  Thus  a computational  space 
consisting  of  two  nested  17  x 17  x 33  grids  will  be  17  x 2 x 0.2  = 6.8 
meters  wide  in  the  X and  Y direction  and  33  x 2 x 0.2  = 13.6  meters 
wide  in  the  Z direction. 

The  default  value  is  0.1  m. 

6.4.16  ZTRUNCATE 

The  card: 

ZTRUNCATE  zlo  zhi 

allows  the  user  to  select  the  beginning  and  ending  coordinates  for  the 
outermost  grid  in  the  Z direction.  The  coordinate  system  used  is  the 
default  (with  the  center  at  0 0 0)  or  the  one  defined  by  the  latest 
'OFFSET1  card  (6.4.6). 

For  example 

ZTRUNCATE  -15  10 

defines  the  outer  grid  to  run  from  Z = -15  (instead  of  Z = -16)  to  Z = 
10  (instead  of  Z = 16).  The  outer  grid  must  always  include  outermost 
but  one.  For  example  grid  #2  extends  from  -8  to  +8  in  grid  #3  units, 
then  grid  #3  can  only  be  truncated  to  a minimum  of  +8. 

ZTRUNCATE  -7,  10 

for  example  puts  one  boundary  of  grid  #3  inside  the  boundary  of  grid 
#2.  This  is  illegal. 

ZTRUNCATE  is  particularly  useful  for  defining  the  walls  of  a 
test  tank.  Note  that  it  differs  from  NZ  (6.4.8)  in  that 

1.  only  the  outer  grid  is  truncated. 

2.  the  grid  may  be  truncated  asymmetrically. 

The  default  is  to  leave  a full  NZ  length  outer  grid. 
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6.5  RUN  OPTIONS  THAT  CONTROL  PRINTED  OUTPUT 


6.5.1  APRT 

As  part  of  its  printed  output  NASCAP  may  tabulate  the  final 
potential  array  (i.e.,  the  potentials  at  each  grid  point)  after  each 
TRILIN  call.  The  card: 

APRT  n 

gives  the  number  of  grids  for  which  potentials  are  printed  out.  The 
default  is  1,  i.e.,  potentials  are  printed  for  just  the  inner  grid. 
Potentials  may  be  printed  for  all  the  grids  requested,  or  for  none, 
using  this  command.  For  example 
APRT  3 

will  cause  potential  arrays  to  be  printed  out  for  all  three  grids  in  a 
three  grid  problem,  or  just  the  innermost  three  grids  in  a 4 or  more 
grid  problem. 

6.5.2.  CONVERGENCE  PLOTS 
The  card: 

CONVERGENCE  PLOTS  ON 

causes  a printer  plot  of  the  square  of  the  residual  vector  {r  «r)  for 
each  iteration  to  be  produced  after  each  cycle.  The  residual  vector 
is  explained  in  Section  3.15.1  dealing  with  the  conjugate  gradient 
potential  solver.  The  default  is  not  to  print  the  plot.  This  result 
is  also  achieved  with  the  card: 

CONVERGENCE  PLOTS  OFF 

The  convergence  plots  are  only  useful  as  a diagnostic  tool,  to  check 
the  conjugate  gradient  potential  solver  as  working  correctly. 

Problems  in  this  respect  are  sometimes  solved  by  increasing  the 
maximum  number  of  iterations  using  POTCON  (6.2.8). 
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6.5.3 


PRINT/NOPRINT 


The  card: 

PRINT  <(sub)modu1e> 

causes  diagnostic  information  to  be  printed  out  during  each  call  to 
the  module  or  submodule  requested.  The  following  four  (sub)modules 
may  be  printed: 

HIDCEL 

OBJDEF 

LIMCEL  (called  when  LONGTIHESTEP  is  requested  - 6.2.6) 
POTENT  (potential  solver  called  from  CAPACI  and  TRILIN) 

The  default  mode  is  not  to  print  messages,  except  for  OBJDEF,  which 
has  an  intermediate  level  of  print,  from  a module  unless  specifically 
requested  with  a PRINT  card.  For  example 
PRINT  LIMCEL 

causes  diagnostic  information  to  be  printed  on  calls  to  TRILIN  when 
LONGTIMESTEP  has  been  requested  (6.2.6).  PRINT'S  can  be  explicitly 
turned  off  with  the  card: 

NOPRINT  <(sub)module> 

For  example 

NOPRINT  LIMCEL 

cancels  a previously  requested  PRINT  LIMCEL.  The  information  printed 
out  is  for  diagnostic  purposes  only  and  is  not  needed  for  the  usual 
operation  of  the  code.  Warning:  The  HIDCEL  module  is  capable  of 
producing  an  extremely  large  volume  of  diagnostic  information. 

6.5.4  SURFACE  CELL 

In  Section  3.10  we  discuss  how  each  exposed  face  of  a filled 
volume  element,  or  surface  cell,  is  assigned  a surface  cell  number  n. 
The  card: 

SURFACE  CELL  n 

causes  a breakdown  of  the  net  flux  to  surface  cell  number  n to  be 
printed  after  each  cycle.  Contributions  from  incident  primary  fluxes. 
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secondary  emission,  backscatter  and  conductivity,  as  well  as  infor 
mat ion  about  the  surface  cell  itself  are  printed  out.  The  format  of 
the  breakdown  is  shown  in  Figure  6.4.  A card  is  required  for  each 
surface  cell  to  be  printed.  The  default  when  no  surface  cell  card  is 
included  in  the  options  file  is  to  print  a breakdown  for  cell  #1  only. 

6.5.5  SURFACE  CORNER  AND  SURFACE  AT 

The  same  flux  breakdown  that  is  printed  when  a SURFACE  CELL  card 
is  included  in  the  options  file  (Figure  6.4)  can  also  be  printed  using 
the 

SURFACE  CORNER  x y z <norx  nory  norz> 
card.  Instead  of  referring  to  the  cell  according  to  its  NASCAR 
assigned  number  (as  in  the  case  with  SURFACE  CELL),  SURFACE  CORNER 
refers  to  the  cell  by  the  coordinates  of  the  lowest  indexed  corner 
(x  y z)  of  its  associated  volume  cell,  and  where  this  still  does  not 
uniquely  determine  it,  the  direction  of  its  surface  normal  (norx, 
nory,  norz).  The  lowest  indexed  corner  is  the  one  with  the  least 
positive  sum  of  coordinates  X +Y  +Z.  The  associated  volume  cell  is 
the  cell  in  which  it  is  located,  or  out  of  which  it  points. 


For  example,  consider  a cube  extending  one  mesh  unit  in  the 
positive  direction  from  -1  -1  -1.  The  bottom  face  in  the  X Y plane 

has  vertices: 

-1  -1  -1 
0 -1  -1 
-1  0 -1 
0 0-1 

The  lowest  indexed  vertex  —1  -1  -1  has  a sum  = —3.  However  two 

other  faces  in  the  XZ  and  YZ  planes  also  share  this  lowest  indexed 
vertex.  To  uniquely  determine  the  XY  face  we  must  also  specify  its 
normal,  which  points  in  the  -Z  direction;  i.e., 
norx,  nory,  norz  = 0 0 -1 

A flux  breakdown  for  the  bottom  X Y cell  is  requested  with  the  card: 
SURFACE  CORNER  -1  -1-100  -1 
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Figure  6.4.  Flux  breakdown  for  SURFACE  CELL  28. 


The  coordinate  system  used  by  SURFACE  CORNER  is  either  the 
default  system  (region  at  mesh  center)  or  the  one  defined  by  the  most 
recent  OFFSET  card  (6.4.6).  SURFACE  CORNER  cannot  be  used  until  the 
object  has  been  defined.  Since  RDOPT  always  precedes  a call  to  OBJDEF 
this  means  that  SURFACE  CORNER  can  only  be  used  in  subsequent  calls  to 
RDOPT  (perhaps  in  a RESTART  run). 

SURFACE  AT  is  the  same  as  SURFACE  CORNER  except  that  it  uses  the 
absolute  coordinates  option  (See  5.8.1). 

6.5.6  TIMER/NOTIME 

The  card: 

TIMER 

included  in  the  options  file  causes  the  computer  time  left  for  the 
NASCAP  run  to  be  printed  out  after  each  significant  step  in  the 
calculation.  For  example,  if  400  seconds  were  requested  for  the  run 
(using  the  job  control  language  of  the  machine  running  the  code)  the 
messages  like: 

TIME  LEFT  398 
TIME  LEFT  372 

etc.,  would  be  printed  out  periodically  as  the  run  progresses.  NASCAP 
(UNIVAC  version)  will  not  begin  another  TRIL IN  cycle  when  the  time 
left  is  less  than  300  seconds.  The  300  seconds  allow  NASCAP  to  finish 
the  cycle  it  is  on  and  save  all  files  cleanly  before  run  time  actually 
expires  completely.  Run  time  checks  (for  smaller  amounts  of  time) 
also  occur  in  the  HIDCEL  module  (and  the  POTENT  submodule).  NASCAP 
(UNIVAC  version)  should  always  be  run  with  at  least  ten  minutes  of 
time  requested. 

The  default  behavior,  and  the  card: 

NOTIME 

suppress  the  printing  of  the  TIME  LEFT  messages. 
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6.6  RUN  OPTIONS  THAT  CONTROL  GRAPHICAL  OUTPUT 


6.6.1  3D-VIEW 

The  card: 

3D- VIEW  x y z 

adds  an  additional  perspective  view  to  the  three  views  of  the  object 
usually  plotted  by  SATPLT  (8.7).  The  coordinates  x y z give  the  point 
from  where  object  is  to  be  observed.  Up  to  five  views  may  be  produced 
by  each  call  to  SATPLT.  By  default  the  following  sequence  of  four 
cards  is  assumed: 

3D-VIEW  NONE 
3D-VIEW  58-5 
3D-VIEW  -585 
3D-VIEW  2-5  5 

This  establishes  the  three  default  views  usually  produced  by  SATPLT. 
The  card: 

3D-VIEW  NONE 

clears  all  previous  view  entries.  This  card  can  be  used  in  the 
options  file  to  cancel  the  three  default  views.  The  user  may  then 
specify  up  to  five  of  his  own  views.  If  no  '3D-VIEW  NONE'  card 
precedes  declaration  of  additional  views,  then  a maximum  of  two  may  be 
added  to  the  three  already  there.  The  authors  recommend  directions 
such  as  ' 1 2 3‘  as  tending  to  produce  aesthetically  pleasing  views 

of  NASCAP  object. 

6.6.2  CONTOURS 

NASCAP  can  produce  potential  contour  plots  after  completed 
cycles  using  the  CONTOURS  command.  The  default  behavior  is  not  to 
plot  any  potential  contours.  The  card: 

CONTOURS  STANDARD 

causes  six  standard  contour  plots  to  be  produced  every  cycle.  Plots 
may  be  made  for  any  plane  parallel  to  an  axis  plane  in  any  grid.  Up 
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to  14  specific  plots  may  be  requested  with  cards  of  the  form: 


CONTOURS 


(*\ 

( Y Jcut  # <GRIDS  ng  MOD  n> 


The  X Y and  Z refer  to  the  direction  of  the  normal  to  the  plane  in 
which  the  contours  are  to  be  plotted,  and  "cut#  " refers  to  the  grid 
point  along  this  direction,  through  which  the  plane  passes.  For 
example,  the  card: 


CONTOURS  Y 6 


chooses  a plot  of  contours  in  the  X Z plane  passing  through  the  point 
0 6 0,  i.e.,  a plane  cutting  the  Y axis  at  point  Y = 6.  Since  'GRIDS' 
and  'MOD'  are  omitted,  plotting  occurs  including  all  the  space  to  the 
outermost  grid  and  the  plots  will  be  produced  every  cycle  (n  = 1). 


The  optional  keyword  'GRIDS'  is  used  to  specify  the  number  of 
grids  to  include  in  the  plot.  The  keyword  'MOD'  means  "produce  a plot 
every  n cycles".  For  example 

CONTOURS  Y 6 GRIDS  1 MOD  5 

would  produce  a contour  plot  for  the  plane  cutting  the  Y axis  at  Y = 6 
including  only  the  i nner  grid,  every  five  cycles. 

A specifically  requested  contour  plot  may  be  turned  off  with  the 

card: 


CONTOURS 


cut#  OFF 


For  example  the  above  plot  can  be  turned  off  using 
CONTOURS  Y 6 OFF 

Note  that  all  coordinates  are  in  inner  mesh  units,  and  refer  either  to 
the  default  origin  (grid  center)  or  the  one  defined  by  the  latest 
OFFSET  (6.4.6). 
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The  'CONTOURS  STANDARD'  command  is  equivalent  to  the  following 
sequence: 


CONTOURS 

X 

0 

GRIDS  1 

MOD 

1 

CONTOURS 

X 

0 

GRIDS  ng 

MOD 

1 

CONTOURS 

Y 

0 

GRIDS  1 

MOD 

1 

CONTOURS 

Y 

0 

GRIDS  ng 

MOD 

1 

CONTOURS 

Z 

0 

GRIDS  1 

MQD  1 

CONTOURS 

Z 

0 

GRIDS  ng 

MOD 

1 

(where  ng  = outermost  grid). 

The  MOD  number  may  be  controlled  by  the  user  independently  with 
the  command: 

CONTOURS  STANDARD  <M0D  n> 

For  example: 

CONTOURS  STANDARD  MOD  5 

will  produce  the  same  standard  six  contours  given  above  every  five 
cycles  instead  of  every  cycle. 

6.6.3  DESTINATION 

The  card: 

DESTINATION  dest 

establishes  the  destination  device  for  the  NASCAP  produced  plots,  such 
as  a graphics  terminal,  electrostatic  printer,  microfiche,  etc.  The 
options  'dest'  are  site  dependent  and  should  be  determined  during 
installation  of  the  code.  At  S-Cubed  the  active  values  for  'dest'  are: 
NONE  - user  input  at  run  time  requested  (default) 

COMPRS  - written  to  file  41  (may  be  processed  later) 

CALC  - the  CALCOMP  plotter 

TEKT  - the  Tektronix  graphics  terminal 

ELEC  - electrostatic  plotter 

The  mechanics  of  NASCAP  plotting  are  discussed  in  Chapter  9. 
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6.6.4 


MATVIEW 


Module  SATPLT  (8.7)  also  produces  plots  showing  the  pattern  of 
the  different  surface  materials  covering  the  satellite.  The  card: 

(* 

MATVIEW  + I Y 

can  be  included  in  the  options  file  to  add  different  views  for 
material  plots  to  those  already  selected  by  default.  The  'X  Y Z' 
selects  the  direction  from  which  the  object  is  to  be  viewed.  Cuta  and 
cutb  give  the  coordinates  (inner  grid)  of  the  observer  and  how  far  he 
can  see  along  the  axis  chosen.  For  example: 

MATVIEW  -X  -4  10 

selects  a view  from  the  negative  X direction  with  the  observer  at 

X = -4  and  includes  all  surfaces  between  the  observer  and  X = 10.  The 

card: 

MATVIEW  +X  -4  10 

selects  a view  from  the  positive  X direction  with  the  observer  at 
X = 10  and  includes  surfaces  between  the  observer  and  X = -4. 

The  default  selection  of  views  is  equivalent  to  the  cards: 


MATVIEW 

NONE 

MATVIEW 

+X 

-8 

8 

MATVIEW 

-X 

-8 

8 

MATVIEW 

+Y 

-8 

8 

MATVIEW 

-Y 

-8 

8 

MATVIEW 

+Z 

-16 

16 

MATVIEW 

-Z 

-16 

16 

MATVIEW 

NONE 

cancels  all  previous  view  selections,  including  the  six  initially 
specified  by  default.  Up  to  five  views  may  be  chosen  for  each  of  the 
six  possible  directions. 


^ cuta  cutb 
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The  coordinate  system  used  is  the  default  grid  centered  one  (in 
inner  grid  units)  or  the  most  recent  one  defined  by  an  'OFFSET'  card 
(6.4.6). 


6.6.5  REPEAT 

The  card: 

REPEAT  n 

causes  any  plot  to  be  repeated  n times.  The  default  is  to  make  each 
plot  just  once.  This  feature  is  not  general  and  is  hardware 
dependent.  It  should  be  used  only  on  sites  where  it  is  known  to  be 
implemented  (e.g.,  NASA/Lewis). 

6.6.6  SHEATH 

The  card: 

SHEATH 

activates  the  option  that  causes  plots  of  particle  trajectories  and 
charge  densities  around  the  spacecraft  to  be  plotted  for  space 
environments  (5.4).  The  default  behavior  is  not  to  calculate  or  plot 
these  quantities.  The  same  effect  is  explicitly  brought  about  with 
the  card: 

NOSHEATH 

6.6.7  TANKCUR 

The  card: 

TANKCUR  ON 

causes  a contour  plot  of  current  density  to  be  produced  for  TEST 
TANK-1  runs  (5.8).  The  default  behavior  is  not  to  plot  this 
quantity.  The  same  effect  is  brought  about  with  the  card: 

TANKCUR  OFF 
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6.6.8 


TANKTRAJ 


TANKTRAJ  ON  and  TANKTRAJ  OFF  are  exactly  analogous  to  the 
TANKCUR  commands  explained  in  6.6.7.  TANKTRAJ  refers  to  particle 
trajectory  plots  in  a TEST  TANK-1  case,  rather  than  current  density. 

6.6.9  TITLE 

The  card: 

TITLE  title 

causes  a user  specified  title  to  appear  in  the  first  frame  plotted, 
along  with  the  date  and  time  of  the  NASCAP  run.  The  default  title  is 
NASCAP 

The  'title'  must  begin  in  column  9.  For  example  the  card: 

TITLE  STAN'S  TANK  RUN 
+ col umn  9 

will  cause  the  phrase 

'STAN'S  TANK  RUN’ 

to  replace  'NASCAP'  in  the  first  plot  frame. 

6.7  OPTIONS  DEFINING  LOGICAL  UNIT  NUMBERS 

The  default  values  for  the  logical  unit  numbers  of  the  NASCAP 
files  are  shown  in  Tables  2.3  and  2.4.  These  file  numbers  can  be 
changed  to  other  values  by  including  cards  in  the  run  options  file  of 
the  form 

filename  number 

For  example  the  logical  unit  number  of  file  IKEYWD  may  be  changed  from 
the  default  value  of  26  to  46  with  the  card: 

IKEYWD  46 

The  other  file  names  shown  in  Table  6.7  can  be  used  in  a similar  way. 
Some  examples  are: 

IP  48 
ISPCTR  23 
I PART  42 
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6.8 


OPTION  CHECKLIST 


The  large  number  of  NASCAP  options  described  in  this  chapter  is 
enough  to  befuddle  even  an  experienced  user.  Clearly,  some  are  of 
more  importance  than  others.  For  this  reason,  we  have  divided  them 
into  four  categories  by  frequency  of  use.  These  are  shown  in 
Table  6.8. 

The  “most  commonly  used"  options  should  be  familiar  even  to  a 
beginning  user.  We  suggest  that  (with  the  obvious  exception  of 
RESTART)  they  always  appear  in  the  options  file,  even  though  the 
defaults  may  be  acceptable. 

The  "other  commonly  used  options"  control  output  or  commonly 
encountered  aspects  of  charging  problems. 

The  "less  commonly  used  options"  are  for  diagnostic  purposes,  or 
require  care  in  use,  or  are  relatively  specialized. 

The  "rarely  used  options"  are  those  which  have  acceptable 
defaults,  or  serve  to  restore  defaults,  or  are  nearly  obsolete. 

Options  considered  totally  obsolete,  even  though  still 
functional,  have  been  omitted  from  this  manual. 
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TABLE  6.8A.  MOST  COMMONLY  USED  OPTIONS 
DELTA 
END 

IOUTER 

LONGT IMESTE  P/NOLONGT IMESTE  P 

NCYC 

NG 

NZ 

RESTART 

TIMER 

TYPE 

XMESH 
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TABLE  6.8B.  OTHER  COMMONLY  USED  OPTIONS 
3D- VIEW 
BFIELD 
BIAS 
CIJ 

CONTOURS 

CONVEX 

DESTINATION 

FIXP 

SUNDIR 

SUNINT 

SURFACE  AT 

SURFACE  CELL 

SURFACE  CORNER 

TANK  AXIS 

TANKCUR 

TANK  RADIUS 

TANKTRAJ 

TITLE 


ZTRUNCATE 


TABLE  6.8C.  LESS  COMMONLY  USED  OPTIONS 
APRT 
DEADLINE 
DEBYE 
DELFAC 

DIPOLE  MOMENT 

DISCHARGE 

EFFCON 

EMITTER 

FLASHOVER 

FLDCON 

IFLUX 

MAT VIEW 

NOPRINT 

OFFSET 

PRINT 

RADCON 

RIJ 

SECONDARY  EMISSION 

SHEATH 

UPDATE 
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TABLE  6.8D.  RARELY  USED  OPTIONS 
CONVERGENCE  PLOTS 
FLOAT 
IAREA 
IAUN 
ICNOW 
IDIV 
IKEYWD 
IOBJ 
IOBPLT 
IP 

I PART 

IPQCND 

IR 

I ROUS 

ISAT 

ISPARE 

ISPCTR 

IU 

NOEMITTER 

NOSHEATH 

NOTIMER 

REPEAT 

SCALE /NOSCALE /DSCALE 


7.  NASCAP  PARTICLE  TRACKING 


7.1  INTRODUCTION 

NASCAP  calculates  particle  trajectories  in  order  to  simulate 
particle  emitters  and  detectors,  electron  guns  (TYPE  1 Test  Tank),  and 
to  calculate  space  charge  density  (SHEATH  option).  In  the  case  of 
particle  detectors,  particles  incident  upon  a particular  surface  cell 
are  backtracked  to  determine  their  origin.  This  allows  a statistical 
estimate  of  the  arriving  current  as  a function  of  parameters  such  as 
incident  energy  and  angle  of  incidence.  Unlike  particle  detectors, 
emission  affects  the  object  potential  since  a new  source  of  current  is 
introduced.  The  emitted  current  is  taken  into  account  in  this 
respect.  Emitted  particle  trajectories  are  calculated  by  NASCAP,  and 
the  trajectory  plots  produced  can  be  used  to  estimate  the  emitted 
current  returning  to  the  spacecraft.  NASCAP  includes  both  emitted  and 
return  current  in  its  potential  calculations. 

The  detector  simulation  is  activated  by  executing  the  module 
DETECT.  The  particle  emitter  simulation  is  activated  by  including  the 
keyword  'EMITTER'  in  the  run  options  file  (6.2.4).  Examples  of  the 
other  two  uses  of  particle  tracking  may  be  found  elsewhere  in  this 
volume.  Let's  begin  by  discussing  the  DETECT  module. 

7.2  DETECT 

7.2.1  OVERVIEW 

The  DETECT  module  calculates  and  plots  incident  energy  flux 
density  as  a function  of  incident  energy  and  direction  for  both  ions 
and  electrons.  The  energy  flux  density  is  the  quantity  actually 
measured  by  spacecraft  particle  detector  experiments.  It  is  a measure 
of  the  number  of  particles  collected  per  second,  times  their  energy 
(i.e.,  the  incident  current  weighted  by  the  energy  of  the  incident 
particles) . 
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NASCAP  considers  a detector  to  reside  on  a given  surface 
cell.  The  range  of  incident  energy  and  incident  solid  angle  of  the 
incoming  particles  that  the  detector  is  able  to  measure,  is  chosen  by 
the  user.  DETECT  then  calculates  the  energy  flux  density  arriving 
within  a cone  about  the  direction  chosen,  and  within  the  energy  range 
chosen.  It  takes  into  account  deflection  of  the  particles  by. electric 
fields  due  to  charging  on  the  object,  deflection  by  magnetic  fields, 
and  "mechanical"  deflection.  "Mechanical"  deflection  occurs  when  a 
particle  that  would  have  reached  the  detector  otherwise,  collides  with 
another  piece  of  the  spacecraft  obstructing  the  view. 

A typical  field  of  view  for  a detector  is  shown  in  Figure  7.1. 
Particles  are  assumed  to  be  collected  if  they  arrive  within  a cone 
about  the  incident  direction  chosen.  The  width  of  the  cone  is  given 
by  ae  (Figure  7.1).  i gives  the  azimuthal  angle  of  the  incident 
direction  about  the  surface  normal.  The  angle  e is  the  angle  between 
the  incident  direction  and  the  surface  normal  of  the  cell  chosen  as 
the  position  of  the  detector.  The  integrated  energy  flux  (i.e.,  the 
total  collected  by  the  whole  cone)  is  calculated.  Plots  of 
differential  energy  flux  as  a function  of  any  one  of  the  three 
variables  incident  energy,  e and  0,  may  be  requested.  (One  variable 
becomes  the  plot  abscissa  while  the  other  two  are  held  fixed.) 

DETECT  is  used  to  simulate  the  operation  of  particle  detector 
experiments  under  spaceflight  conditions,  when  the  spacecraft  is 
charged.  It  is  also  useful  in  investigating  focussing  and  deflection 
effects  due  to  charging  of  the  spacecraft  in  general. 

7.2.2.  EXECUTION  OF  DETECT 

The  module  DETECT  must  be  preceded  by  execution  of  TRILIN  or 
IPS  since  they  both  establish  potentials  on  the  surface  of  the 
spacecraft.  (Exact  precedence  is  summarized  in  Table  2.2.).  DETECT  is 
executed  by  including  the  card: 

DETECT  <n> 
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Figure  7.1.  Typical  field  of  view  for  a Detector. 
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in  the  NASCAP  runstream.  The  optional  parameter  n specifies  the 
number  of  the  file  where  DETECT  is  to  look  for  input.  The  default 
value  of  n is  5,  in  which  case  DETECT  expects  its  input  cards  to 
follow  immediately  in  the  runstream.  DETECT  input  must  be  terminated 
with  its  own  'END'  card,  whether  it  resides  in  file  n or  the  NASCAP 
runstream.  If  DETECT  is  the  last  module  to  be  executed  in  a NASCAP 
run  this  means  that  two  'END1 2 3  cards  are  necessary  to  terminate  the 
runstream:  one  for  the  DETECT  file  and  one  for  the  whole  runstream 

(2.4).  For  example,  a runstream  might  end  as  follows: 


TRILIN 


DETECT 


DETECT 

INPUT 

FILE 


DETECT 

INPUT 

CARDS 


END 


END 


The  DETECT  input  cards  can  be  classified  into  three  groups 
according  to  their  function: 

(1)  Definition  of  detector  location  and  orientation. 

(2)  Control  of  the  particle  tracking  and  current  integration. 

(3)  Control  of  plots  produced. 

We  examine  each  of  these  functions  in  the  following  three  sections. 
7.2.3  DEFINITION  OF  THE  DETECTOR 

The  detector  may  lie  on  the  plane  of  any  surface  cell.  It 
collects  particles  arriving  within  a cone  about  a chosen  direction. 
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(This  is  shown  in  Figure  7.1).  The  choice  of  surface  cell,  incident 
direction  and  the  width  of  the  cone  are  all  specified  using  keywords 
in  a DETECT  input  file.  The  energy  range  of  the  incoming  particles 
that  are  detected  may  also  be  chosen  in  this  way. 

Direction  is  specified  using  a cell-based  polar  coordinate 
system.  In  this  system  the  surface  normal  defines  the  +Z  axis.  The  X 
and  Y axes  lie  in  the  surface  plane.  The  X axis  is  chosen  to  lie  on 
top  of  the  projection  of  the  surface  normal  in  the  XY  plane  of  the 
computational  grid,  i.e.,  the  projection  of  the  surface  X axis  and  the 
surface  normal  on  the  grid  XY  plane  are  coincident.  Direction  in  this 
surface  cell  system  is  determined  by  the  polar  coordinates  e and  tf.  e 
is  the  angle  between  the  normal  (the  Z axis)  and  the  direction  vector. 
6 is  the  angle  between  the  X axis  and  projection  of  the  direction 
vector  on  the  surface  plane  in  a counterclockwise  sense.  For  example, 
a 1 1 1 vector  in  this  system  would  point  between  the  positive  axes 
and  have  coordinates  e = 45°  and  i*  • 45°.  The  Y axis  has  coordinate 
e = 90°  and  i = 90°. 

The  cone  about  the  direction  vector  is  defined  by  the 
half-angle,  or  width,  ae. 

The  keywords  that  determine  these  quantities  have  the 
following  syntax. 

7. 2. 3.1  DETECT 

The  detector  input  file  must  begin  with  the  card 
DETECT 

This  tells  the  DETECT  module  that  a new  detector  definition  is  to 
follow. 


More  than  one  detector  can  be  defined  within  a DETECT  input 
file.  A new  detector  is  specified  by  including  another  DETECT  card. 
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All  input  cards  following  one  DETECT  are  assumed  to  refer  to  that 
detector  until  another  DETECT  card  is  encountered.  For  example,  a 
DETECT  input  file  defining  multiple  detectors  might  have  the  form: 


DETECT 

( PARAMETERS  FOR 
| FIRST  DETECTOR 

DETECT 

( PARAMETERS  FOR 
j SECOND  DETECTOR 

DETECT 

(PARAMETERS  FOR 
j THIRD  DETECTOR 


END 


Note  that  more  than  one  detector  may  be  defined  for  the  same  surface 
cell  (pointing  in  perpendicular  directions  for  example). 

7. 2. 3. 2 ICELL 

The  location  of  the  detector  is  set  with  the  card: 

ICELL  n 

The  parameter  n gives  the  surface  cell  number  where  the  detector  is  to 
reside.  If  no  ICELL  card  is  included  before  the  other  input  cards  it 
is  assumed  to  reside  on  surface  cell  number  one  by  default. 

Detectors  on  boom  cells  are  allowed  but  require  special 
treatment.  This  is  explained  in  Section  7.2.4  Note  that  boom  cells 
follow  surface  cells,  i.e.,  an  object  with  158  surface  cells  and  13 
boom  cells  will  have  boom  cells  numbered  159-171. 
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7. 2. 2. 3  ENERGY 


The  detector  collects  particles  with  energy  in  the  range  from 
E to  E + aE.  The  energy  E is  defined  with  the  card 
ENERGY  E 

where  E is  in  eV.  For  example, 

ENERGY  2000 

will  set  E to  2 keV.  The  default  value  assumed  if  no  ENERGY  card  is 
included  is  10  eV. 

7. 2. 3. 4 DEK 

The  energy  accepting  "width"  of  the  detector  aE  is  determined 
by  the  value  of  DEK. 

it-t  x ($£) 

DEK  is  the  percentage  of  E equal  to  aE.  It  is  set  with  the  card 
DEK  d 

The  default  value  is  0.  For  example,  if  E were  set  at  2 eV  and  DEK  at 
10: 

ENERGY  2000 
DEK  10 

then  the  detector  would  collect  particles  with  energies  in  the  range 
2000-2200  eV. 

7. 2. 3. 5 THETA 

The  detector  collects  particles  that  fall  within  a cone 
around  a chosen  direction.  This  direction  is  determined  by  its  polar 
coordinates  d and  e,  in  the  surface  cell  system  described  in  7.2.3. 
THETA  (e)  is  the  angle  between  the  chosen  direction  and  the  surface 
normal.  It  is  set  with  the  card: 

THETA  e 
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« must  be  in  degrees  and  lie  between  + 90.  The  default  value  is  0 
(i.e.,  along  the  surface  normal). 

7. 2. 3. 6 DTH 

The  aperture,  or  width  of  the  cone  about  the  chosen  direction 
of  the  detector  is  determined  by  its  half  angle  ao.  This  is  set  with 
the  card 

DTH  ao 

ao  may  range  from  0 to  90°.  The  default  value  is  0.  For  example: 

DTH  8 

sets  ao  to  8°. 

7. 2. 3. 7 PHI 


The  angle  o does  not  uniquely  define  the  chosen  direction. 

One  more  angle  is  required.  The  angle  4 is  the  angle  between  the 
projection  of  the  chosen  direction  in  the  surface  cell  plane  and  the  X 
axis  of  the  surface  coordinate  system  (in  the  counterclockwise  sense). 
(See  7.2.3).  This  is  set  with  the  card 
PHI  4 

where  4 is  in  degrees  and  may  take  values  from  0 to  360°.  The  default 
is  0 (i.e.,  the  chosen  direction  lies  in  the  XZ  plane  of  the  surface 
system) . 

7.2.4  BOOM  DETECTORS  (ZETA) 

Detectors  are  placed  on  booms  in  just  the  same  way  as  other 
cells.  They  are  assumed  to  lie  at  the  center  of  the  boom  segment  or 
cell  specified.  Since  the  surface  of  the  boom  is  cylindrical  there  is 
no  unique  direction  for  the  surface  normal,  and  hence  no  unique  surface 
cell  coordinate  system.  This  problem  is  overcome  by  defining  the  angle 
between  the  projection  of  the  chosen  boom  surface  normal  and  a grid 
axis,  in  the  grid  plane  perpendicular  to  the  boom.  For  example,  if 
the  boom  lies  along  the  grid  Z axis  the  projection  of  the  boom-normal 
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is  in  the  grid  XY  plane,  and  the  angle  s(Zeta)  is  measured  from  the 
grid  X axis.  This  is  shown  in  Figure  7.2.  For  booms  along  the  other 
axis,  the  labels  are  cyclicly  permuted. 

The  angle  zeta  is  set  using  the  card 
ZETA  C 

The  default  value  of  zeta  is  0.  For  example: 

ZETA  25 

sets  £to  25°.  If  the  detector  is  not  on  a boom  cell,  ZETA  is  ignored. 
7.2.5  CONTROL  OF  PARTICLE  TRACKING  AND  CURRENT  INTEGRATION 

The  particle  tracking  algorithm  moves  the  particles  in 
steps.  The  number  of  steps  included  in  the  trajectory  calculation  is 
chosen  by  the  user  as  'NSTP'.  Each  step  is  designed  to  move  each 
particle  the  same  distance.  Thus  faster  moving  (higher  energy) 
particles  have  shorter  times  associated  with  each  step.  The  distance 
associated  with  the  steps  is  determined  by  the  "code  velocity"  VCODE. 
The  greater  VCODE  the  greater  the  distance  associated  with  each  step. 

It  is  important  that  the  particles  tracked  from  the  detector 
move  far  enough  to  be  able  to  reach  at  least  the  boundary  of  the  inner 
grid.  The  choice  of  NSTP  and  VCODE  should  be  made  with  this  in  mind. 
In  general,  the  larger  VCODE,  the  smaller  NSTP  may  be  while  still 
allowing  the  particles  to  reach  the  boundary,  (since  the  distance 
associated  with  each  step  is  greater).  However,  as  the  step  distance 
increases  the  accuracy  of  the  calculation  is  decreased.  Hence,  there 
is  a trade  off  between  the  number  of  steps  (computation  time)  and 
accuracy.  A good  compromise  can  usually  be  made  by  choosing  VCODE  and 
NSTP  so  that  particles  reach  the  boundary  in  a few  hundred  steps. 

To  calculate  the  integrated  current  arriving  at  the  detector 
in  the  range  of  energy  and  direction  selected  during  its  definition, 
particles  must  be  tracked  for  a sample  of  values  of  E,  e and  i.  The 
number  of  samples  taken  over  the  energy  range  and  the  range  of  e 
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Figure  7.2.  Boom  cell  coordinate  system. 


and  t are  specified  by  the  user.  Each  new  combination  causes  another 
particle  to  be  tracked.  If  the  number  of  samples  to  be  taken  in  all 
three  variables  is  chosen  to  be  10,  then  all  10  x 10  x 10  = 1000  • 
combinations  must  be  tracked.  The  larger  the  number  of  samples  chosen 
the  more  accurate  are  the  integrated  currents  calculated,  but  the 
computational  effort  is  greatly  increased. 

To  understand  these  principles  more  clearly,  let's  examine 
the  ways  the  variables  we  have  discussed  are  controlled. 

7. 2. 5.1  NSTP 

The  number  of  steps  to  be  taken  for  each  particle  in  reverse 
trajectory  calculations  is  set  with  the  card: 

NSTP  n 

n can  take  values  from  1 to  30,000.  The  default  value  of  500  is  a 
reasonable  choice  for  tracking  inside  the  inner  grid.  If  particles 
are  to  be  tracked  out  to  further  grids  at  least  400  more  steps  should 
be  added  for  each  extra  grid.  For  example,  if  tracking  is  to  occur 
out  to  the  third  grid  NSTP  might  be  set  to  1300. 

NSTP  1300 

These  values  assume  a value  of  VCODE  of  around  0.3  (the  default). 

7. 2. 5. 2 VCODE 

The  particle  code  velocity  or  distance  moved  in  inner  grid 
units  per  step  is  set  with  the  card 
VCODE  v 

The  default  value  is  0.3  ( i . e . , 3 steps  move  a particle  approximately 
1 grid  unit).  This  is  a safe  value  to  use  in  most  applications. 

For  a detector  on  a boom  in  grid  number  IG  this  is 
automatically  scaled  by  the  mesh  size  2^  ^ . 
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7. 2. 5. 3  NE 


The  number  of  points  sampled  over  the  energy  range  E + E + aE 
(7.2.3)  is  set  with  the  card: 

NE  n 

n may  take  the  value  1 or  any  even  value  up  to  12.  The  default  value 
is  1.  For  example  the  following  cards 
ENERGY  2000 
DEK  10 

NE  4 

set  the  energy  range  to  2000-2200  eV.  Four  representative  energies 
are  sampled  within  this  range.  If  NE  is  1,  the  (single)  sample  energy 
is  chosen  equal  to  E. 

7. 2. 5. 4 NMU2 

NMU2  sets  the  number  of  points  sampled  over  the  width  of  the 
detector  cone  (over  ae). 

NMU2  n 

n may  take  any  positive  value.  The  default  is  1.  For  example: 

NMU2  10 

sets  the  number  of  samples  over  ae  to  10. 

7. 2. 5. 5 NP 

The  number  of  points  taken  around  the  perimeter  of  the  cone 
is  set  with  the  card 
NP  n 

This  breaks  up  the  interval  of  the  azimuthal  angle  d1  in  the  detector 
coordinate  system  from  360°  to  360 °/n.  The  default  value  of  n is  1, 
in  which  case  d1  is  chosen  to  be  0.  (See  Figure  7.1  for  definition  of 
d*.) 
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7.2.6  CONTROL  OF  PLOTS 


Two  types  of  DETECT  plots  are  produced:  plots  of  energy  flux 

density  against  one  of  the  variables  E,  e and  0,  and  particle 
trajectories. 

The  variable  E,  •©,  or  0,  chosen  for  the  plot  of  energy  flux 
density  is  called  the  Independent  Variable.  The  range  of  the 
independent  variable  and  the  number  of  points  plotted  are  also 
selected  by  the  user. 

Plots  are  made  for  both  ions  and  electrons  on  the  same  graph. 
The  scales  and  pen-type  can  all  be  set  by  the  user  independently,  or 
chosen  automatically  using  the  AUTOS  option. 

Particle  trajectory  plots  show  a silhouette  of  the  spacecraft 
and  lines  representing  the  path  of  each  of  the  particles  tracked.  For 
each  request,  views  in  each  of  the  three  grid  axis  planes  are  plotted 
for  both  electrons  and  ions  ( i . e, , a total  of  six  plots).  Trajectory 
plots  may  be  made  in  more  than  one  grid,  and  in  more  grids  than  were 
actually  included  in  the  potential  calculation  in  the  first  place  (NG). 
This  is  to  allow  for  the  effect  of  large  radius  curved  trajectories 
induced  by  magnetic  fields.  The  potential  v in  the  grids  outside  the 
outer  computational  grid  is  assumed  to  be  derived  from  a monopole  at 
the  object  center  with  charge  q (equal  to  the  total  charge  on  the 
object)  i.e.. 


where  r is  the  distance  from  the  object  center. 

Examples  of  both  types  of  plot  are  given  in  Figures  7.3 

and  7.4. 


Let's  examine  the  remaining  DETECT  input  cards  that  control 
the  plots. 
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ENERGY  FLUX  IN  EV/ (CM2-SEC-SR-EV)  AT  CYCLE  0 MEASURED  BY 
DETECTOR  LOCATED  AT  CELL  NUMBER  1 (INTERPOLATED  AT  10  POINTS) 
PROTON  FLUX  (HEAVY)  SCALED  BY  1.00*005  ELECTRON  FLUX  (LIGHT!  UNSCRLED. 


Figure  7.3.  Detector  energy  flux  vs  energy  plot. 


sixy-z 


TRAJECTORIES  AT  CYCLE  0 FOR  ELECTRONS  IN  1 GRIDS  RECEIVED  8Y  DETECTOR 
LOCATED  AT  CELL  NUMBER  1 PROJECTED  ONTO  THE  X-Z  PLANE 


Figure  7.4.  Detector  particle  trajectory  plot. 
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7. 2. 6.1  INDVAR 


The  independent  variable  is  set  with  the  card: 

INDVAR  = var 

var  may  be  the  words  ENERGY,  THETA  and  PHI,  corresponding  to  the 
choice  of  E,  e or  d as  the  variable  which  energy  flux  density  is 
plotted  against.  The  default  selection  is  ENERGY.  The  scale  of  the 
axis  in  the  plot  depends  on  the  choice  of  variable  as  follows: 


Independent  Variable 

Independent  Variable 
Axis  Scale 

ENERGY  (E) 

LOG 

THETA  (e) 

LINEAR 

PHI  (4) 

LINEAR 

The  dependent  variable,  energy  flux  density,  is  always 
plotted  on  a LOG  scale. 

7. 2. 6. 2 FINALV 

The  range  of  the  independent  variable  in  the  plot  begins  at 
the  value  chosen  in  the  definition  of  the  detector  and  ends  at  the 
value  set  with  the  card 
FINALV  f 
For  example,  the  cards: 


THETA 

45 

PHI 

10 

ENERGY 

10,000 

DEK 

10 

INDVAR  = 

ENERGY 

FINALV 

20,000 
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define  a detector  direction  with  e = 45°  and  i = 10°  (in  the  surface 
system)  which  remains  fixed,  in  a plot  of  energy  flux  density  against 
initial  energy  where  the  energy  range  is  swept  from  (lOkeV,  11  keV) 
to  (20  keV,  22  keV). 

The  default  value  of  f is  49999  eV,  since  the  default 
independent  variable  is  ENERGY.  If  e and  i>  are  chosen  as  independent 
variables  FINAL V must  be  changed  explicitly  from  this  default  value  to 
an  acceptable  limit  for  the  variables.  For  e acceptable  limits  are 
within  + (90-ae)°.  For  i>  FINALV  may  range  from  0 to  720°. 

7. 2. 6. 3 N 

The  number  of  points  included  in  the  energy  flux  density  plot 
is  set  with  the  card 
N n 

N has  a default  value  of  20,  and  must  be  between  3 and  500.  For 
example,  the  same  plot  discussed  in  7. 2. 6. 2 can  be  made  with  50  points 
using  the  cards: 

THETA  45 

PHI  10 

ENERGY  10,000 

DEK  10 

INDVAR  = ENERGY 
FINALV  20,000 

N 50 

7. 2. 6. 4 AUTOS 

The  card 
AUTOS 

included  in  the  detector  definition  causes  automatic  scaling  of  the 
calculated  energy  flux  density  in  the  plot  against  the  independent 
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variable.  The  default  behavior  is  to  require  manual  selection  of 
scale  using  the  FLXMAX  and  FLXMIN  options  discussed  below.  The  use  of 
AUTOS  is  highly  recommended. 

7. 2. 6. 5  FLXMIN  AND  FLXMAX 


The  minimum  and  maximum  values  on  the  energy  flux  density 
axis  of  the  plot  against  the  independent  variable  may  be  set  using 
FLXMIN  and  FLXMAX.  For  example,  the  cards 
FLXMIN  1.E6 
FLXMAX  1.E14 


6 2 

will  set  the  minumum  value  to  10  eV/(cm  s sr  eV)  and  the  maximum 
14  2 

to  10  eV/(cm  s sr  eV).  The  scale  is  logarithmic.  Default 
4 12 

values  are  10  and  10  respectively.  These  cards  are  ignored 
when  the  AUTOS  option  (7. 2. 6. 4)  is  in  force. 


7. 2. 6. 6  PSCALE 


Since  the  ion  fluxes  are  an  order  of  magnitude  or  two  less 
than  the  electron  fluxes,  and  both  curves  are  overlaid  on  the  same  set 
of  axes,  it  is  often  convenient  to  scale  the  ion  fluxes  by  a factor 
p.  This  is  set  using  the  card 
PSCALE  p 

For  example,  the  card 

PSCALE  1.E2 

will  scale  a proton  flux  of  6 x 108  eV/(cm2  s sr  eV)  to  6 x 10 10 

c 

for  the  purpose  of  a plot.  The  default  value  is  p = 10  . 

7. 2.6.7  LWPEN 

To  distinguish  the  ion  and  electron  curves  on  the  same  graph, 
the  ion  energy  fluxes  are  plotted  with  a broader  penstroke.  The 
number  of  vector  points  covered  by  the  penstroke  for  the  ion  curve  may 
be  set  with  the  card 

LWPEN  n 
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n may  take  a value  between  1 and  10.  The  default  is  3.  Electron 
curves  are  always  drawn  with  a width  of  1. 

7. 2. 6.8  LABABV 

If  the  card 
LABABV 

is  included  in  the  detector  definition  the  headings  on  the  plot  will 
be  omitted.  This  saves  time  when  plotting  on  interactive  graphics 
terminals  but  is  apt  to  lead  to  confusion. 

7. 2. 6. 9 PRFLUX 


If  the  card 
PRFLUX 

is  included  in  the  detector  definition  values  of  energy  flux  density 
included  in  the  plot  will  be  tabulated  as  printed  output  also. 

7.2.6.10  PL PART 

The  particle  trajectory  plots  are  not  automatically  produced 
by  default.  Including  the  card 
PLPART 

in  the  detector  definition  causes  a minimum  of  6 plots  to  be  produced, 
giving  views  in  each  of  the  grid  axis  planes  for  both  ions  and 
electrons.  The  plots  extend  to  the  highest  grid  reached  by  any  of  the 
particles.  The  grids  plotted  can  also  be  controlled  with  the 
following  options. 

7.2.6.11  NGBND 


card 


The  number  of  grids  included  in  the  plot  may  be  set  with  the 


NGBND  n 

n may  take  integer  values  greater  than  0.  If  n = 0 the  highest  grid 
reached  by  particles  is  automatically  included,  n is  zero  by  default. 
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For  example 
NGBND  5 

will  include  only  the  first  five  grids  in  the  trajectory  plots,  even 
if  some  particles  actually  reached  into  grid  6 and  higher. 

7.2.6.12  NGPLOT  AND  NGINC 

It  is  possible  to  make  up  to  4 different  sets  of  plots  of  the 
same  trajectories  including  the  same  or  different  grids.  The  card 
NGPLOT  n 

sets  the  number  of  sets  to  n.  n can  take  integer  values  from  1 to  4. 
The  default  is  1.  The  card 
NGINC  m 

sets  the  increment  for  the  outer  boundary  for  successive  plots.  For 
example,  the  cards 

NGBND  1 
NGPLOT  3 
NGINC  2 

will  produce  three  sets  of  plots  of  the  same  trajectories  with  the 
outermost  grid  number  IG  given  by 

IG  = NGBND  + (1-1)  x NGINC 
(for  I = 1,  2,  3) 

i.e.  with  IG  = 1,  3,  and  5. 

The  default  value  of  NGINC  is  0.  NGBND,  NGINC  and  NGPLOT 
must  all  be  chosen  so  that  IG  does  not  exceed  LIMGRD. 

7.2.6.13  LIMGRD 

The  highest  grid  in  which  particles  may  be  tracked  is  set 
with  the  card 

LIMGRD  n 
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n may  take  any  positive  value  above  zero.  The  default  value  is  NG, 
the  number  of  grids  included  in  the  computational  space.  IIMGRD  may 
exceed  NG,  in  which  case  a monopole  potential  is  used  beyond  the 
computational  space. 

7.2.6.14  MODPAR 

To  save  plotting  time  not  all  the  line  segments  making  up  a 
particle  trajectory  need  be  plotted.  The  card 
MODPAR  n 

causes  only  every  nth  line  segment  to  be  plotted.  For  example 
MODPAR  2 

causes  every  other  line  segment  to  be  plotted.  The  choice  of 
MODPAR  0 

IR 

causes  n to  be  set  to  2 -1,  where  IR  is  the  grid  number  on  which 
the  plot  is  taking  place.  Then  in  the  inner  grid,  all  the  line 
segments  are  plotted.  In  the  2nd  grid,  every  other  one  is  plotted,  in 
the  3rd,  every  4th  one  and  so  on.  The  default  value  of  n is  0. 

7.2.7  THE  DETECT  INPUT  FILE:  EXAMPLE 

Figure  7.5  shows  a sample  detector  input  file  with  comments 

explaining  each  card.  Figure  7.6  shows  the  printed  output  generated 
by  the  DETECT  module  associated  with  this  input.  A second  example 
illustrating  the  use  of  DETECT  is  given  in  Chapter  11. 

7.3  EMITTER 

7.3.1  OVERVIEW 

Particle  emitters  are  defined  in  essentially  the  same  way  as 
particle  detectors.  The  emitter  is  positioned  on  a particular  surface 
cell,  and  the  particles  emitted  from  a cone  about  a chosen  direction 
are  tracked  over  a range  of  energies  defined  by  the  user.  Those  that 
reach  the  outer  boundary  of  the  computational  space  are  considered  lost 
to  the  spacecraft. 
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Figure  7.5.  NASCAP  detector  keyword  file  to  perform  an  energy  scan  over  25  points  logarithmically 

spaced  from  10  eV  to  50  keV.  Detector  looking  in  the  direction  of  the  normal  to  surface 
cell  225. 
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The  total  emitted  current  is  considered  a loss  of  charge 
(either  positive  or  negative  depending  on  whether  ions  or  electrons 
are  emitted)  to  the  underlying  conductor  associated  with  the  emitter 
surface  cell.  Particles  that  return  to  the  spacecraft  (i.e.,  collide 
with  its  surface)  are  considered  to  be  a source  of  charge  for  the 
cells  collecting  them.  Hence  both  the  emission  of  the  particles  and 
their  subsequent  collection  are  taken  into  account  by  TRILIN  in 
calculating  currents  to  the  object  and  object  potential. 

The  emitter  option  should  be  considered  a realistic  model 
only  for  particle  emitters  operating  at  low  current  density.  This  is 
because  NASCAP  does  not  take  into  account  the  formation  of 
space-charge  barriers  in  front  of  the  emitter.  Space-charge  effects 
become  significant  for  electron  emission,  at  currents  greater  than  a 
few  milliamperes  and  for  proton  emission  at  currents  greater  than 
about  0.1  milliamperes. 

Plots  of  particle  tracks  can  be  produced  in  any  number  of 
computational  grids  (as  selected  by  the  user). 

7.3.2  EXECUTING  EMITTER 

Unlike  DETECT  the  emitter  option  is  not  a separate  module. 

An  emitter  is  defined  and  included  in  a TRILIN  calculation  by 
including  the  card 

EMITTER  <n> 

in  the  run  options  file  (6.2.4).  The  parameter  n gives  the  file 
number  where  the  emitter  input  cards  are  to  be  found.  The  default 
value  of  n is  5.  If  n = 5 is  chosen  the  input  cards  must  follow 
TRILIN  in  the  NASCAP  runstream.  If  the  flux  definition  file  is  also 
file  5 (the  NASCAP  runstream)  then  the  emitter  input  cards  should 
follow  the  flux  definition  cards. 
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The  emitter  input  file,  like  the  DETECT  input  file  should  be 
terminated  with  an  'END'  card  (7.2.2).  The  emitter  input  cards  fall 
into  the  same  three  groups  as  for  DETECT  and  in  many  cases  fulfill  the 
same  functions.  These  are: 

(1)  Definition  of  the  emitter 

(2)  Control  of  the  particle  tracking 

(3)  Control  of  the  plots  produced. 

We  examine  these  in  turn. 

7.3.3.  DEFINITION  OF  THE  EMITTER 

An  emitter  is  defined  in  almost  exactly  the  same  way  as  a 
detector  (Figure  7.1).  One  difference  is  that  the  beam  of  emitted 
particles  must  have  an  energy  distribution  rather  than  range.  The 
choice  is  restricted  to  a Gaussian  or  Lorentzian  distribution.  The 
beam  is  assumed  to  be  emitted  within  a cone  defined  around  the  chosen 
direction.  The  angular  distribution  of  the  beam  within  this  cone  must 
also  be  selected.  The  two  possible  choices  are  a uniform  distribution 
and  one  biased  towards  the  center  axis  of  the  cone  by  the  factor 
cos  o'  (where  o'  is  the  angle  between  any  direction  and  the  center 
axis  of  the  cone).  This  is  discussed  in  greater  detail  in  Section  7.4. 

The  direction  of  the  emitter  is  defined  by  specifying  the 
polar  angles  e and  i of  the  central  axis  of  the  cone,  in  the  same  cell 
coordinate  system  described  for  the  detector  (7.2.3).  The  first  step, 
however,  is  to  announce  a new  emitter  with  the  EMITTER  keyword.  All 
parameters  defined  following  EMITTER  are  assumed  to  refer  to  the  same 
emitter  until  a further  EMITTER  card  is  encountered.  In  this  way, 
more  than  one  emitter  may  be  defined.  No  two  emitters  may  occupy 
surface  cells  associated  with  the  same  underlying  conductor. 
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7. 3. 3.1  EMITTER 


Just  like  the  detector  card  DETECT  (7.2.3.1),  EMITTER  must  be 
the  first  card  in  the  Emitter  input  file.  All  cards  following  EMITTER 
refer  to  the  same  emitter  until  a new  EMITTER  card  is  encountered. 
Hence  more  than  one  emitter  may  be  defined  in  any  one  emitter  input 

file.  No  two  emitters  may  be  on  surface  cells  associated  with  the 
same  conductor. 

For  example,  an  emitter  file  defining  two  emitters  has  the 

form 


EMITTER 

( parameters  for 
» first  emitter 

EMITTER 

( parameters  for 
| second  emitter 

END 

where  each  emitter  is  associated  with  a different  conductor. 

The  cards  used  to  define  the  emitter  are  described  below. 

7. 3. 3. 2 ICELL 

The  card 

ICELL  n 

locates  the  emitter  on  surface  cell  number  n.  The  cell  may  be  a boom 

cell  (but  see  7.3.3.11).  The  default  value  of  n (if  no  ICELL  card  is 
included)  is  n = 1. 

7. 3.3.3  ENERGY 

The  card 

ENERGY  E 
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sets  the  peak  value  in  eV  of  the  energy  distribution  of  the  emitted 
particle  beam.  The  default  value  is  1000  eV.  For  example, 

ENERGY  2000 

sets  the  peak  value  to  2000  eV. 

7. 3. 3. 4 JTYPE 


The  card 

JTYPE  n 

determines  the  energy  and  angular  distribution  function  types, 
discussed  in  7.3.3  and  7.4.  n may  take  integer  values  from  1 to  4. 
The  default  is  JTYPE  = 1.  The  significance  of  each  value  is 
summarized  in  the  table  below. 


JTYPE 


Distribution  Chosen 


1 

2 

3 

4 

7. 3. 3. 5 SIGMA 


Uniform  Angular,  Gaussian  energy 
Cosine  e Angular,  Gaussian  energy 
Uniform  Angular,  Lorentzian  energy 
Cosine  e Angular,  Lorentzian  energy 


card 


The  width  s in  eV  of  the  energy  distribution  is  set  with  the 


SIGMA  s 

The  default  value  is  0.1  eV.  For  example,  the  cards 


ENERGY  2000 
JTYPE  2 
SIGMA  10 


define  a beam  with  a Gaussian  energy  distribution  centered  at  2000  eV, 
with  a width  of  10  eV  (7.4)  and  an  angular  distribution  weighted 
towards  the  chosen  direction  by  cos  e (7.4). 


7. 3. 3. 6  PHI 


The  card 
PHI  t 

sets  the  azimuthal  angle  in  degrees  of  the  emitter  orientation  in  the 
surface  cell  system.  The  default  is  t = 0°.  This  is  exactly  analogous 
to  the  detector  card  PHI  (7.2. 3. 7). 

7. 3. 3. 7 THETA 

The  card 

THETA  e 

sets  the  polar  angle  « (in  degrees)  of  the  emitter  orientation  in  the 
surface  cell  system.  The  default  is  e = 0.  This  is  exactly  analogous 
to  the  detector  card  THETA  (7. 2. 3. 5). 

7. 3. 3. 8 DTHETA 

The  card 

DTHETA  ae 

sets  the  half-angle  width  of  the  cone  about  the  emitter  direction,  in 
degrees.  The  default  is  ao  = 0.  This  is  exactly  analogous  to  the 
detector  card  DTH  (7. 2. 3. 6). 

7. 3. 3. 9 BEAMI 

The  card 

BEAMI  i 

sets  the  total  emitter  beam  current  to  i amps.  The  default  is 
i = 1 x 10  amps.  For  example 
BEAM  2.E-5 

-5 

sets  the  current  to  2 x 10  amps. 
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7.3.3.10  ISPEC 


Whether  the  emitter  emits  protons  or  electrons  is  determined 
with  the  card 

ISPEC  n 

where  n may  take  the  value  1 for  an  electron  emitter  and  2 for  a 
proton  emitter.  The  default  is  a proton  emitter  ISPEC  = 2. 

7.3.3.11  ZETA 

If  an  emitter  is  to  be  defined  for  a boom  cell,  the  angle 
zeta  s,  fixing  the  surface  plane,  must  be  specified.  This  is 
explained  in  7.2.4. 

7.3.4  CONTROL  OF  PARTICLE  TRACKING 

The  particle  tracking  for  emitters  is  carried  out  in  just  the 
same  way  as  for  detectors.  Again  there  is  a trade-off  between  the 
number  of  particle  tracking  steps  taken  to  reach  the  boundary  and  the 
accuracy  of  the  calculation.  This  is  explained  in  Section  7.2.5. 

The  duration  of  the  first  tracking  step  for  each  particle  is 
chosen  so  that  the  distance  it  moves  is  equal  to  the  code  velocity  set 
by  VEDOWN  (rather  than  VCODE  used  for  a detector).  This  duration  is 
retained  for  further  steps  unless  the  distance  moved  exceeds  VEDOWN  or 
falls  below  VEUP  when  it  is  adjusted  to  fall  within  these  limits. 

The  number  of  particles  tracked  by  each  emitter  is  given  by 
the  product 

NPHIS  x NTHETS  x NENGS 
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where  NPHIS,  NTHETS  AND  NENGS  are  the  number  of  samples  in  *5,  e and 
energy.  These  correspond  exactly  to  NP,  NMU2,  AND  NE  in  the  detector 
case.  (7. 2. 5. 5,  7. 2. 5. 4,  7. 2. 5. 3). 

Let's  examine  these  input  cards  more  carefully. 

7.3.4. 1 NSTEPS 

The  card 

NSTEPS  n 

sets  the  number  of  particle  tracking  steps  to  n.  n may  range  from  1 
to  2500.  The  default  is  500.  Only  the  first  800  steps  are  plotted. 

In  all  other  respects  NSTEPS  is  identical  to  the  DETECT  parameter  NSTP 
(see  7. 2. 5.1). 

7. 3. 4. 2 VEDOWN 

The  card 

VEDOWN  d 

sets  the  maximum  number  of  mesh  units  that  any  particle  may  move  in  a 
single  particle  tracking  step.  Hence  the  particle  tracking  steps 
associated  with  particles  having  different  velocities  (energies)  have 
different  durations.  The  step  duration  is  initially  set  for  each 
particle  so  that  it  moves  a distance  equal  to  VEDOWN  in  the  first 
step.  If  the  particle  is  subsequently  accelerated  so  that  it  would 
move  a distance  greater  than  VEDOWN  in  a step,  the  duration  of  the 
step  is  automatically  cut  back. 

The  default  value  is  0.3  inner  mesh  units.  This  is  a 
reasonable  value  to  use  in  most  cases. 

When  particles^ enter  higher  grids,  VEDOWN  is  automatically 
scaled  by  the  factor  2 , where  IG  is  the  number  of  the  grid.  For 

example,  if  the  particle  reaches  the  third  grid  IG  = 3,  and  VEDOWN  is 
scaled  by  22  = 4. 
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7.3.4. 3 VEUP 


Particles  can  be  decelerated  as  well  as  accelerated  and  the 

card 


VEUP  u 

sets  the  minimum  distance  that  each  particle  must  move  in  a particle 
tracking  step  before  the  step  duration  is  automatically  increased. 
The  minimum  distance  in  inner  mesh  units  is  defined  by 


min  distance  = 


VEDOWN 

~WUT 


The  default  value  of  VEUP  is  5.  Then  if  VEDOWN  is  set  at  5,  then  the 
minimum  distance  moved  by  each  particle  is  0.3/5  = 0.06  inner  mesh  units. 

Like  VEDOWN  (7. 3. 4. 2)  VEUP  is  scaled  by  the  factor  in 

grid  number  16. 


7. 3. 4. 4 SCALEV 


The  scaling  of  VEDOWN  and  VEUP  for  higher  grids  can  be  changed 

IQ_1 

from  the  factor  2 to  an  arbitrary  factor  f with  the  card 
SCALEV  f 

The  default  value  is  1.0.  SCALEV  is  only  effective  for  grids  higher 
than  2. 


For  example,  with  the  card 
SCALEV  5 

TP  i 

VEDOWN  and  VEUP  would  be  scaled  by  a factor  2 =2  for  the  second 

grid  but  by  the  factor  5 for  the  third  and  higher  grids. 

SCALEV  is  a global  command  and  affects  all  of  the  emitters  in 
the  input  file. 
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7. 3. 4. 5  NENGS 


The  card 

NENGS  n 

sets  the  number  of  energies  to  be  sampled  over  the  range  of  the  energy 
distribution  function  chosen.  The  range  is  divided  up  into  n - 1 pieces 
so  that  each  corresponds  to  an  equal  weight  (or  number  of  particles). 

The  default  value  is  1. 

NENGS  is  analogous  to  the  DETECT  keyword  NE  (7. 2. 5. 3). 

7. 3. 4. 6 NTHETS 

The  card 

NTHETS  n 

sets  the  number  of  samples  to  be  taken  in  the  angle  e across  the  range 
of  the  cone  ae.  The  default  is  1.  NTHETS  is  analogous  to  the  DETECT 
keyword  NMU2  (7. 2. 5. 4). 

7. 3. 4. 7 NPHIS 

The  card 

NPHIS  n 

sets  the  number  of  samples  to  be  taken  in  the  angle  i&',  (the  azimuthal 
angle  around  the  cone  axis).  The  default  value  is  1.  This  is  analogous 
to  the  DETECT  keyword  NP  (7. 2. 5. 5). 

7. 3. 4. 8 CYMULT 

Particles  are  considered  lost  when  they  pass  out  of  the  highest 
grid  specified  by  LIMGRD  (7.2.6.13).  LIMGRD  may  be  higher  than  the 
highest  computational  grid  (NG).  (For  tracking  in  grids  outside  NG  a 
monopole  potential  (7.2.6)  is  assumed.) 
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Particles  are  also  considered  lost  when  moving  in  grids  higher 
than  NG  for  a time  longer  than  a limit  set  by  the  card 
CYMULT  n 

For  an  environment  with  a non-zero  magnetic  field  B,  n corresponds  to 
the  number  of  "cyclotron"  revolutions  for  the  particle. 

Time  limit  = n x | m^ss  j 

When  the  magnetic  field  is  zero  the  time  limit  is  given  by  n x T^q, 
where  TMq  is  the  time  spent  escaping  from  the  first  NG  grids  (the 
computational  space).  The  default  is  1.  For  zero  magnetic  field 
CYMULT  should  be  set  to  around  5.0. 

7.3.5  CONTROL  OF  PLOTS  AND  PRINTED  OUTPUT 

« 

Emitter  produces  only  one  type  of  plot.  This  shows  the 
trajectories  of  the  emitted  particles.  Views  are  plotted  in  the  three 
grid  axis  planes.  The  trajectories  may  be  plotted  in  more  than  one 
grid,  and  even  out  to  grids  beyond  the  computational  space.  If  trajec- 
tories extend  beyond  the  computational  space  the  potential  is  assumed 
to  be  monopole  (7.2.6). 

Extra  printed  output  can  be  requested  showing  the  cells 
affected  by  capture  of  emitted  particles,  and  the  histories  of  each 
particle  emitted. 

The  following  input  cards  control  these  features. 

7. 3. 5.1  NGBND,  NGPLOT,  NGINC 

The  keywords  NGBND,  NGPLOT  and  NGINC  control  the  number  of 
grids  included  in  the  trajectory  plots.  These  are  explained  in 
Sections  7.2.6.11  and  7.2.6.12. 
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7. 3. 5. 2  LIMGRD 


The  card 

LIMGRD  n 

sets  the  number  of  the  highest  grid  in  which  particle  tracking  to  to 
take  place.  The  default  value  is  6.  If  n exceeds  2 or  NG  (see  6.4.7) 
then  a monopole  potential  is  assumed  in  higher  grids  (7.2.6).  LIMGRD 
is  a global  command  (7. 3. 4. 4). 

7. 3. 5. 3 IPLTYP 

The  card 

IPLTYP  n 

sets  the  type  of  particle  trajectory  plots  produced,  n may  take  the 
values  0 or  1.  If  n = 0 three  separate  projection  views  for  each 
emitter  are  produced.  If  n = 1 the  plots  for  each  emitter  are 
combined  on  a single  set  of  three  projection  views.  IPLTYP  only  has 
an  effect  when  more  than  one  emitter  is  defined.  The  default  value  is 
1 (i.e.,  combined  emitter  plots). 

This  is  a global  command  (7. 3. 4. 4). 

7. 3. 5. 4 JCYCEM 

The  card 

JCYCEM  n 

causes  trajectory  plots  to  be  produced  for  every  n computational 
cycle.  If  n = 0 no  plots  are  produced.  The  default  value  is  0 (no 
plots).  For  example  the  card 
JCYCEM  2 

will  produce  plots  every  other  NASCAP  code  cycle. 

This  is  a global  command  (7. 3. 4. 4). 
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7. 3. 5. 5.  PRFLUX 


If  the  card 
PRFLUX 

is  included  in  the  emitter  input  file  a list  of  all  surface  cells  that 
capture  a particle  will  be  printed  for  each  particle  emitter.  This 
card  should  usually  be  included  in  the  input  file.  Again  this  is  a 
global  command  (7. 3. 4. 4). 

7. 3. 5. 6 IPRNT 


If  the  card 

IPRNT 

is  included  in  the  input  file  a summary  of  each  particle  tracked  is 
produced.  This  has  the  following  form. 

I PHI  index  number  of  discrete  azimuthal  angle  at 

which  the  particle  was  emitted. 

ITH  index  number  of  discrete  polar  angle  at  which 

the  particle  was  emitted. 

IEK  index  number  of  discrete  energy  at  which  the 

particle  was  emitted. 

VINIT  initial  code  velocity  with  which  particle  was 
emitted  (in  inner  grid  units/timestep) . 

VIN  initial  velocity  with  which  particle  was 

emitted  (in  meters/ second) . 

JCLAST  index  number  of  volume  cell  which  particle 

was  in  at  step  just  before  hitting  the  satel- 
lite. If  the  trajectory  was  incomplete  this 
will  be  0.  (Note  the  volume  index  is  not 
necessarily  the  same  as  the  surface  cell 
index! ) 

PXYZ  potential  (in  volts)  at  the  particle  position 

at  the  last  timestep  completed  prior  to 
hitting  the  satellite  or  abandoning  tracking. 
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JR  index  number  of  grid  in  which  the  particle  was 

in  at  the  last  timestep  completed  prior  to 
hitting  the  satellite  or  abandoning  tracking. 

ISTF  number  of  discrete  steps  which  this  particle 
was  tracked  for  before  it  hit  the  satellite  or 
tracking  was  abandoned. 

7.3.6  EXAMPLE  OF  AN  EMITTER  INPUT  FILE 


Figure  7.7  shows  a sample  emitter  input  file.  Figure  7.8 
shows  the  printed  output  from  a completed  run,  and  Figures  7.9 
and  7.10  show  two  views  of  the  particle  trajectories. 

7.4  TECHNICAL  DISCUSSION 

7.4.1  PARTICLE  DETECTORS 


(a)  Calculation  of  Energy  Flux  at  a Cell  Surface 


In  order  to  obtain  an  expression  for  the  energy  flux  density 
measured  by  a detector  located  at  a given  surface  cell  of  the 
satellite  model  it  is  helpful  to  first  consider  the  general  problem  of 
calculating  the  total  energy  flux  which  is  incident  at  the  surface  of 
the  cell  due  to  the  ambient  plasma  environment.  Let  k be  the  unit 
normal  vector  for  the  surface  cell.  Using  the  cell's  rectangular 
coordinate  system  (obtained  by  appropriate  rotation  of  the  satellite 
coordinate  system)  with  the  +Z  axis  in  the  direction  of  k,  the  energy 
flux  at  the  cell  surface  center  is  calculated  as  follows: 


(eVo-k)  f#(y  ) 


d3V 


0 


where  tQ  = energy  flux  vector  (eV/(M2-sec))at  cell  surface. 
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1 lEHITTER 

2 5 1 CELL  3 
3sehergv  teee 

4ISICHA  10 
5 * D THETA  5 
6t8EAHI  2. E-5 
7INENGS  10 
8UCYCEN  1 
9JPRFLUX 
10 i END 
EOF lie 
eo 


Figure  7.7 . 


Sample  Emitter  input  file. 
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Figure  7.8.  (Continued). 
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Figure  7.8.  (Continued). 


o 

~ xo 
oo 


© ^ wO  *- 

UJ  o un 

H-  l-»  < X 

*-«  u aw 


X 

UN  < 

w 

a u. 

X 

o 

i/i 

o 

< 

M 

a 

•N 

w 

>- 

o 

m 

1 

m 

z 

o 

— <0 

w 

z 

WO  • 

a 

X 

►-  60 

a 

o 

w 

X 

w 

O 

u 

> 

(/) 

~0 

o 

a 

o — 

w 

w 

SO  wO 

w 

WO  U- 

w 

w 

• N 

3 

u* 

oc  z 

n 

•* 

UO 

X 

•N 

o 

W 

< 

wo 

o 

O 

A uJ 

*- 

♦ 

♦ 

o 

w 

c 

CO 

o 

o 

>o 

« 

o 

> 

• 

C 

• 

> 

U0 

<M 

* • 

o 

1 

VO  a 

o 

x* 

auo  a- 

♦ 

UO 

X a 

a 

rg 

O 

<o 

3 

o 

— i 

o 

1 

♦ 

o 

• 

o 

WO  II 

ca 

o 

zo 

i 

« 

o 

NO  >- 

o* 

• 

1 • N 

eg 

W<S|  un 

o 

l 

x z 

W UN 

U* 

II 

w 

«-N 

ii 

z 

UN 

a 

UN 

a 

o 

CL 

o 

a n» 

o 

c 

u 

o 

a 

> 

►-  w 

u 

V 

u o 

3 

X 

i 

o z 

O 

t 

o— * « 

Z 

o 

Z U- 

o 

c 

** 

o u« 

o 

a 

o 

u u 

u 

-< 

I— 

i 

w 

a 

w 

i 

M 

«* 

uO 

i 

w 

o 

u» 

a 

z 

• -J 

X 

u> 

•—1 

o-*  NT 

UJ 

CJ 

:» 

z u> 

a 

UN 

o 

UJ 

H- 

cc 

w 

a 

1 

o 

o 

a 

o 

c 

o 

o 

♦ 

II 

♦ 

♦ 

♦ 

60 

o 

md 

r* 

CM 

w 

UO 

3 

O 

o 

• 

o 

• 

• 

a 

«n 

• 

sO 

CM 

| 

CM 

V 

1 

V 

UO 

u* 

•n 

U» 

c 

o 

o 

uo 

o 

a 

o 

♦ 

o 

t 

♦ 

1 

>-  a 
o w 

Q U fsi 


II 

J 

ii 

II 

II 

II 

II 

ii 

ii 

•N 

n 

^N 

a 

UN 

a 

un 

a 

un 

a 

a 

u- 

a 

H- 

a 

u- 

a 

w 

U- 

a 

wo 

wo 

o 

w-» 

o 

u* 

© 

U- 

o 

o 

UN 

o 

o 

U 

UO 

o 

u 

o 

w 

o 

CJ 

wO 

wo 

o 

a 

> 

a 

> 

IM 

a 

> 

u- 

a 

> 

»- 

>- 

a 

x. 

V 

V 

3 

V 

u 

X. 

a 

1 

a 

i 

a 

1 

o 

sc 

i 

< 

< 

a 

1 

II 

N- 

i 

1 

U- 

i 

z 

z 

o 

o 

II 

o 

o 

o 

NT 

< 

o 

o 

P4 

w 

o 

^n 

W 

o 

o 

»N 

c 

a 

o 

z 

a 

CD 

z 

a 

o 

a 

3 

UJ 

w 

a 

i 

u 

3 

U 

3 

o 

U 

o 

o 

QC 

i 

1 

1 

1 

1 

1 

1 

1 

1 

UN 

t 

•*© 

o 

1 

o 

1 

o 

1 

*->*- 

o 

o 

z 

1 

o 

z 

1 

N(J 

w 

o 

u 

UN 

w 

X 3 

o 

> 

x 

o 

■J 

u> 

> 

© 

wO 

*-4 

w 

o 
1— » 

< 

w 

a 

o 

UN 

Nt 

mJ 

3 

O 

3 © 
CJ 

w 

X 

-J 

w 

w 

284 


o 

bJ 

<S\ 

X 

«/> 

W*Z 

LiO 

*« 

Z 

MM 

«/> 

WJ«*J 

(/» 

ro 

LO 

fO 

t- 

ao 

a 

** 

to 

o 

a 

a 

o 

za 

L- 

rsi  i 

i 

1 

3S 

o 

y*l 

o 

o 

m 

O 

0'<M 

M 

c 

fM 

LJ_J 

oo 

o 

• 

• 

• 

* 

03 

oo 

z 

m 

O' 

in 

OO 

1 ♦ 

o 

1 

l 

uu 

u 

UV- 

K»<* 

fsjo 

o 

OO 

• • 

O' 

X 

r- 

OO 

z 

o 

o 

o 

o 

♦ 1 

l-H 

o 

o 

a 

o 

1 

i 

i 

yj 

J") 

l/> 

m 

r- 

tnrg 

> 

<\» 

O' 

vO 

O' 

• * 

II 

►L 

• 

• 

• 

• 

m 

CO 

K> 

nO 

<H 

1 

I 

Z 

fcO 

yj 

o 

cc 

CL 

ti 

x 

M. 

3 

•• 

3 •• 

Li 

u 

yO 

UJ  «•» 

«y 

o 

Cl 

M 

ZV) 

z 

a 

X 

<■* 

'—-J 

■< 

Z 

*x 

«J 

*-• 

z 

»«* 

** 

o 

►“  LJ 

L> 

o 

X 

ZD 

X 

O 

uJ 

z 

z 

►“ 

o 

QCO 

M •* 

CH 

X 

-» 

xz 

w«y 

z 

u 

Li 

o 

3n 

1/5 

LJ 

UJ 

X 

o*- 

^-J 

x 

O 

cr 

< 

Z-J 

z 

z 

yj 

3 

> -1 

3 

Z 

O 

*-3 

xo 

D 

z 

z 

z 

u 

Lj 

z 

LJ 

>Z 

3 Lj 

Z 

o 

o 

a 

LH 

ua 

Li 

_i 

« 

►- 

a 

►- 

< 

c. 

a 

u 

3 

ux 

z 

►- 

LJ 

3 

U 

30 

X 

#— 1 

o 

3 

as 

uQO 

<4 

>- 

Z 

►- 

Zl 

X 

O 

LJ 

o — 

yj 

L> 

z 

u 

a 

Z 

285 


Figure  7.8.  (Continued). 
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Figure  7.8.  (Concluded). 


PARTICLE  TRAJECTORIES  AT  CYCLE  1 FROM  I EMITTER  IS)  PROJECTED  ONTO  THE  X-T  PLANE 
CELL  LOCATION  AND  EMITTER  TYPE:  3(P) 


Figure  7.9.  Sample  particle  emitter  trajectory  plot 


-V  ^ ^ ^ 

VQ  = v^i  + Vyj  + vzk  (velocity  at  surface) 

d^V  = dv  dv  dv 
o x y z 

-b 

f0(V  ) = phase  space  density  function  evaluated  at  the 
surface  for  particles  with  velocity  VQ. 

m = mass  of  incident  particles. 

e = charge  of  incident  particles  (electrons  or  protons). 


To  evaluate  the  integral  it  is  expedient  to  change  from 
rectangular  to  spherical  coordinates.  The  necessary  substitutions  are: 


d^VQ  * sine  de  dtf  dvQ 

-+  A 

(eV  • k)  = ev  cose 
o o 


With  these  the  energy  flux  integral  transforms  into 


oo  2ir  ir/2 


E0  = 


4 //  / 

0 0 0 


mv 


o 

2? 


evQ  cose  f0(e,«J,v0)j  sine  de  dri  dvQ 


00  2ir  tt/2 


= f f f (fe)  vo  M dv0 


0 0 0 


where  u = cose. 


Next  we  change  variables  from  vQ  (the  magnitude  of  the 
velocity  at  the  surface)  to  Eq  (the  kinetic  energy  at  the  surface  of 
the  cell ) . 
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Let 


i m v2  * e (factor  e because  Ert  is  in  eV) 
Zoo  0 


edE. 


dv  = 

o mg 


Then  the  energy  flux  integral  becomes 


oo  2ir  1 

h = ~kf  f f 2(i)  Eo  T”  dd  dEc 

0 0 0 


2ir 


■ * f / 2(f)  Eo  fo  (Eo’  V ■ « dE= 


0 0 


where  we  have  introduced  the  solid  angle  as  an  integration  variable 
for  notational  convenience. 

Finally  we  introduce  the  energy  flux  density  function  G(E,ft). 
From  the  definition  we  know  that 


00  2ir 

E0  * -k  / / e0(E0,  S0)  „ dB  dE0 

0 0 

Comparison  of  the  integrands  yields  the  identity 


(if 


fft(E„, 
0 0 


60<E0- 
— 3T 
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This  equation  provides  the  key  to  correct  evaluation  of  G at 
the  cell  surface  by  reverse  trajectory  particle  tracking.  Since  f is 
a constant  along  a particle  trajectory  we  have  for  particles  emitted 
at  the  cell  surface  with  initial  energy  EQ  and  velocity  vector  in 

the  direction  of 

f (E  , $ ) ■ f (E  ,5  ) 

1 0V  0 0J  00  v co’  co' 


Go<Eo-  5o>  G»  (E«*  °-2 


where 

f = phase  space  density  function  evaluated  at  cell  surface. 

f = phase  space  density  function  evaluated  at  infinity. 

00 

G = energy  flux  density  function  evaluated  at  cell  surface, 
o 

q _ energy  flux  density  function  evaluated  at  infinity. 

oo 

F = initial  kinetic  energy  of  particle  to  be  tracked, 
o 

E = kinetic  energy  of  particle  after  reverse  trajectory 

00 

tracking  to  infinity. 

* = initial  velocity  direction  vector  of  particle  at  cell 
o 

surface. 

_ velocity  direction  vector  for  particle  after  reverse 

00 

trajectory  tracking  to  infinity. 

Therefore,  if  the  energy  flux  density  function  G is  known  at 
infinity  then  using  reverse  trajectory  particle  tracking  the  energy 
flux  at  the  surface  of  the  cell  may  be  computed  from 
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-b 

E 

0 


(EL,,  S_)  ) 


u dfi  dE 

o 


This  equation  is  used  (with  slight  modification)  in  the 
following  section  to  arrive  at  an  expression  for  the  energy  flux 

density  which  is  measured  by  a particle  detector  located  on  the 
surface  cell. 


(k)  Detector  Energy  Flux  Density  Measurement 

Consider  an  ideal  particle  detector  located  at  the  center  of 
a surface  cell  and  oriented  such  that  the  +Z  axis  of  the  detector's 
rectangular  coordinate  system  points  in  the  direction  in  which  the 
energy  flux  density  is  to  be  measured.  Assume  that  the  detector's 
rectangular  coordinate  system  is  transformed  into  a spherical 
coordinate  system  and  that  n is  the  unit  normal  pointing  in  the 
direction  in  which  the  particle  detector  is  pointing.  If  the  detector 
responds  to  particles  having  energy  EQ  then  the  measured  value  for 
the  energy  flux  will  be 


where 

-b 

EQ  = energy  flux  vector  at  cell  surface. 

fo  = phase  space  density  function  evaluated  at  cell  surface. 
Eo  = kinetic  energy  (in  eV)  of  particles  at  cell  surface. 
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i - azimuthal  angle  in  detector  coordinate  system. 

e = polar  angle  in  detector  coordinate  system. 

Eoo=  kinetic  energy  (in  eV)  of  particles  after  reverse 
trajectory  tracking  to  infinity. 

^00=  velocity  direction  vector  for  particles  after  reverse 
traj'ectory  tracking  to  infinity. 

m = mass  of  particles. 

GoJE,^)  = energy  flux  density  function  (i.e.,  tabulated 

Deforest  data,  for  example.  Units  are 
2 

eV/(sec-cm  -sr-eV).) 


In  practice,  a real  detector  responds  to  a finite  range  of 
particle  energies  and  velocity  vectors  so  that  the  energy  flux  density 
observed  by  the  detector  is  really  3Z£0/<>E03fi  averaged  over 
the  energy  and  angular  apertures  of  the  detector.  Thus,  in  general, 
the  value  which  the  detector  yields  is  of  the  form 


3ZE 


o 


W(E0,$) 


:°l 


( G (E 

I oo  oo  a 

~~7i 


) 


cose  dft  dEQ 


W(E  .$)  d n dE„ 
0 0 


where  W(Eq,^)  is  a weight  function  which  describes  the 
characteristics  of  the  detector's  energy  and  angular  apertures. 
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In  the  current  version  of  NASCAP  it  has  been  assumed  that  the 
energy  aperture  of  a detector  is  a rectangular  weight  function  which 
has  a value  of  1 from  E to  E + aE  and  0 elsewhere.  The  angular 
aperture  is  assumed  to  be  a hemispherical  cap  of  "width"  as  in  the 
polar  angle.  (The  vector  n passes  through  the  center  of  this  cap.) 

The  weight  has  a value  of  1 anywhere  on  the  cap  and  0 elsewhere. 
Therefore,  NASCAP  detectors  compute  the  energy  flux  density  from 


E+aE  U 1 / 

■v  ift  4 

E 0 COS  A0  V 


3 CO 

insr 

0 


SJE„,i5„)  | 2 

ii  dE 


E+aE  2ir  Ae" 

Iff 


sine  de  d«f  dE, 


E+aE  2*  1 ( n lr-  % \ \ «. 

-ff/  / fz 

E 0 cos  Ae  v L<»  ) 


dd  dE, 


(1  - COSAe)  2ir  aE 


where  u = cose. 

This  integral  is  evaluated  by  a three-dimensional  approxima- 
tion formula  which  uses  the  mid-point  rule  with  n^  points  to  compute 
the  integral  over  rf,  the  mid-point  rule  with  n points  to  compute  the 
integral  over  n , and  the  even-order  Gauss-Legendre  formula  with  n 
points  to  compute  the  integral  over  EQ-  The  composite  formula  used 
is: 
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♦«.k4 


1 

(1-cosAe)  2t  aE 


nt  % 


n /2 


= -n-r£  2 H wkek  F(^i»uj,ek)  + W-ke-k  F {*i»uj»e-k' 


i=l  j=l  k»l 


where 

•k  ■ 4 % + 1' + E 


and 


d.  = |i  (1  - 1/2) 

1 nd 

« 2 
U?  = Au2  (j  - 1/2)  + (1  - n ^ Aii  ) {TP  denotes  » } 
0 


2 2 
An  = (1  - cos  se) /n^ 

= (1  + cosAe)  (mul tiply  by  10‘4  to  put  units  in  cm"2) 
T n, 

ip  p 


G 

00 


(returned  by  FSPACE) 
ijk 


E and  S^are  the  final  energy  and  velocity  vector 
respectively  of  a particle  after  reverse  trajectory  tracking  from  the 
center  of  the  surface  cell  (beginning  with  initial  velocity  specified 
by  (6.,  n2,  and  et)  to  infinity. 

The  and  WR  are  the  Gauss-Legendre  integration 

coefficients  for  n£  an  even  integer.  (Note  the  \ ~ - X_|<  and 
^k  = W k*)  A slightly  modified  formula  is  used  to  permit  ng  - 1. 

(Also  note  that  -1  <_  Xk  £ 1 f°r  all  k.) 

It  should  be  noted  that  although  the  detector  energy  flux 
integral  includes  only  contributions  from  the  ambient  plasma 
environment  it  is  possible  that  some  particle  trajectories  will  yield 
E < 0.  This  could  occur  if  the  particle  originates  from  another  part 

of  the  satellite,  for  example. 
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For  detector  particle  trajectory  plotting  purposes  all 
particles  must  be  tracked  regardless  of  origin.  Therefore,  a test  is 
made  within  the  innermost  integral  simulation  loop  to  determine  if 

E«  - °*  If  it  is  not  then  no  attempt  is  made  to  evaluate  G and  G is 
assumed  to  be  0. 

7.4.2  PARTICLE  EMITTERS 

7.4. 2.1  DISCRETE  PARTICLE  EMISSION  ANGLES  AND  ENERGIES 

The  present  version  of  NASCAP  offers  the  user  two  choices  for 
emission  angle  selection.  One  choice  is  the  uniform  distribution,  a 
special  case  of  which  results  in  each  particle  representing  the  same 
solid  angle  fraction  of  the  current.  The  other  choice  is  a cosine  e 
distribution  in  which  a disproportionate  number  of  particles  are 
emitted  at  angles  "close"  to  the  axis  of  the  hemispherical  cap  (Z-axis 
of  the  enntter  coordinate  system).  Two  choices  for  the  energy 
spectrum  of  the  beam  are  also  provided.  Either  choice  results  in  an 
approximate  representation  of  a mono-energetic  peak  in  the  energy 
spectrum  - the  difference  between  the  two  choices  being  the  mathe- 
matical form  of  the  approximation  function.  The  emission  angles  and 
energy  distribution  functions  available  are  listed  below.  (Any 
angular  dependence  may  be  combined  with  any  energy  dependence.) 

Uniform  Angular  Current  Density  Dependence 

For  each  of  n£  discrete  energies,  n^  n^  particles  are 
emitted.  The  initial  emission  velocity  direction  vector  of  each 
particle  (measured  in  the  emitter  coordinate  system  ) is 

y A ^ 

Vij  = (s1nei  cosei. )i  + (sine  sinjj  )j  + (cose.)k 
J 1 J i j 

where 
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1 - 1,  2,  ...» 


*f  = I2-  d - 1/2) 

t 


ni 


9,  - |2  (j  - 1/2) 
J e 


J = 1,  2, 


n 


e 


For  the  special  choice  of  n,  = n each  particle 

v © 

represents  the  same  solid  angle  fraction  of  the  emitted  current. 


(b)  Cosine  © Angular  Current  Density  Dependence 


For  each  of  n discrete  energies,  n.  n particles  are 

G P 0 

emitted.  The  initial  velocity  direction  vector  of  each  particle 
(measured  in  the  emitter  coordinate  system)  is 


= (sin©,  costf.i  + (sine.  sintf.)j  + (cose. 
J i J i J 


)k 


where 


- I1  (1  - 1/2) 

% 


i = 1 9 2,  • • M n . 


9.J  - rin-1  (( j-lft ) »<"*»)  j k = 1,  2, 


(c)  Gaussian  Energy  Current  Density  Dependence 


A Gaussian  function  may  be  used  as  an  approximation  to  a 
mono-energetic  spectrum.  The  current  density  function  for  the 
Gaussian  approximation  is 


where  Ig  is  the  total  beam  emission  current. 
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It  is  easy  to  show  that 


00 

/ 


J(e)  de  = I 


B ’ 


Since  a real  current  distribution  is  not  defined  for  negative 
energies  the  Gaussian  function  is  only  an  approximate  representation. 
However,  one  can  show  that 


lim  J( e)  = Ig  6(e  - eq)  , 
a ■+  0 


and 


oc 

/ 


J(e)  dE-*ID  for  e > 0 and 

D 0 


« 1. 


Thus  the  mono-energetic  energy  peak  can  be  represented  to  any 
degree  of  accuracy  desired  simply  by  choosing  o/s0  small  enough.  It 
is  worth  noting  that ^68  percent  of  the  current  falls  in  the  range 
c = e + a and  ^92  percent  of  the  current  falls  in  the  range 

E = e0  + 2a. 


NASCAP  chooses  the  discrete  energy  representation  of  the 
Gaussian  energy  distribution  as  follows: 


i = 1,  2,  ...»  n 


where 


(7.1) 


satisfied: 


This  choice  results  in  the  following  equality  being 


ei+l 


/ 


ei 


I 


B 


J(e)  dE  = ff- 
e 


(7.2) 


where  we  define  e = 0 and  e„  = °°. 

o n +1 

e 


298 


Thus  each  discrete  energy  represents  the  same  fraction 
(l/n£)  of  the  total  emitted  current.  Furthermore,  half  of  this 
fraction  is  a result  of  energy  in  the  range  e . ^ € <.  and  half 

is  a result  of  energy  in  the  range  e.  <_  e < 

(d)  Lorentzian  Energy  Current  Density  Dependence 

A Lorentzian  function  may  be  used  as  an  approximation  to  the 
mono-energetic  spectrum.  The  current  density  function  used  by  NASCAP 
for  the  Lorentzian  approximation  is 


where  Ig  = total  emitter  beam  current. 


u = *2  - a^/a  and  a = a/e 


This  density  function  has  the  property  that 


Lirn  J(e)  IR  6(e  - ej 

a +0  B 0 


and 


de  = ID  for  all  o/e  < . 

D o 


NASCAP  chooses  the  discrete  energy  representation  of  the 
Lorentzian  energy  distribution  according  to  Eq.  (7.1)  with  the 
integrand  for  F(X)  replaced  by  the  Lorentzian  density  function  divided 
by  Ig.  This  choice  of  energies  also  results  in  the  satisfaction  of 
the  equality  given  by  Eq.  (7.2). 
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8.  OTHER  MODULES 


There  are  seven  other  NASCAP  modules  still  left  to  discuss.  In 
this  chapter  we  tie  up  these  loose  ends.  Three  of  the  remaining 
modules,  HIDCEL,  SPIN  and  ROTATE  all  concern  the  illumination  of  the 
object  with  sunlight.  NEWMAT  allows  you  to  change  material  properties 
without  redefining  your  whole  object.  SATPLT  lets  you  examine  how 
your  object  looks  from  a number  of  points  of  view.  IPS  allows  you  to 
set  the  initial  potentials  of  insulators  and  conductors  to  some  value 
other  than  zero.  CAPACI  calculates  the  capacitances  of  the  object. 
Finally  STRESS  searches  out  cells  that  have  the  greatest  internal 
electric  fields  and  so  are  most  likely  to  "punchthrough". 

Let  us  begin  by  looking  at  the  shadowing  modules. 

8.1  HIDCEL 

The  fraction  of  the  full  sun  intensity  that  effectively 
illuminates  each  surface  cell  of  an  object  depends  on  its  orientation, 
i.e.,  on  the  angle  e between  the  surface  normal  and  the  negative  of 
the  imagined  velocity  vector  of  the  photons  (i.e.,  the  sun  direction 
vector) : 


I = I cos  e 

For  surfaces  pointing  away  from  the  sun  I is  zero,  and  they  are 
completely  in  shadow. 

Surfaces  that  point  towards  the  sun  may  also  be  completely  or 
partially  in  shadow,  due  to  other  parts  of  the  object  lying  between 
them  and  the  sun.  This  "geometrical"  shadowing  also  contributes  to 
the  overall  illumination  of  each  cell. 


The  module  HIDCEL  calculates  the  fraction  of  each  surface  cell 
that  is  actually  illuminated  by  the  sun  as  a result  of  geometrical 
shadowing.  The  values  it  calculates  form  the  ' shadowing  table' . This 
is  written  out  to  file  21  (2.8)  under  the  keywords  'AREAS'  (for 
non-boom  cells)  and  'BSHAD'  (for  boom  cells).  [Table  2.6.]  TRILIN 
then  calculates  the  effective  sun  intensity  (and  hence  photocurrent) 
for  each  cell  by  multiplying  the  shadowing  table  entry  by  the 
appropriate  cos  e factor  (and  SUNINT  (6.4.11)). 

HIDCEL  is  executed  by  including  the  primary  keyword 
HIDCEL 

in  the  NASCAP  runstream.  HIDCEL  is  usually  executed  immediately 
before  TRILIN.  (Precedence  of  keywords  is  summarized  in  Table  2.2.) 

It  requires  no  user  input  itself,  but  must  be  used  in  conjunction  with 
the  run  options  (Chapter  6)  'SUNINT'  and  'SUNDIR'.  Including  the  card 
SUNINT  s 

in  the  options  file  changes  the  sun  intensity  from  the  default  value 
of  zero  (no  sun  at  all)  to  s.  (This  is  explained  in  Section  6.4.11.) 
Once  SUNINT  is  set  to  a non-zero  value,  photoemission  will  be  included 
in  TRILIN ' s current  calculations,  and  TRILIN  will  look  for  a shadowing 
table  in  file  21.  If  no  shadowing  table  has  been  created  by  a 
previous  execution  of  HIDCEL  an  error  will  occur.  This  can  be  avoided 
either  by  making  sure  HIDCEL  has  been  executed,  or  by  including  the 

card 

CONVEX 

(see  6.4.2)  in  the  options  file.  CONVEX  tells  TRILIN  that  a shadowing 
table  is  not  needed  because  all  entries  in  it  would  be  one.  In  other 
words,  the  object  has  no  surfaces  shielded  from  the  sun  by  the  rest  of 
the  object  (a  sphere,  for  example).  Obviously  most  complex  objects 
are  not  convex  and  for  these  HIDCEL  should  be  executed.  The  shadowing 
table  calculated  depends  on  the  orientation  of  the  object  with  respect 
to  the  sun.  This  is  determined  by  the  user  with  the  run  option 

SUNDIR.  The  card 

SUNDIR  x'  y'  z' 

included  in  the  options  file  changes  the  orientation  vector  defining 
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the  direction  from  the  spacecraft  toward  the  sun  from  its  default 
value  of  X - 1,  Y - 1,  z - 1 to  X - x',  Y - y'#  Z - 2'.  (See  Section 
6.4.10.)  Each  new  choice  of  direction  must  be  accompanied  by  a new 
shadowing  table.  In  other  words  if  SUNDIR  is  changed  a new  call  to 
HIDCEL  must  be  made.  Failure  to  do  this  will  cause  TRILIN  to  use  the 
old  shadowing  table  and  calculate  erroneous  results  with  no  obvious 
error  messages.  Any  calls  to  HIDCEL  for  the  purposes  of  calculating 
photoemission  must  fol low  calls  to  TANK  but  precede  calls  to  TRILIN. 
This  is  discussed  in  Section  5.9.1. 

For  multiple  runs  using  the  same  object  and  the  same  sun 
position,  the  same  shadowing  table  can  be  used  and  so  HIDCEL  need  only 
be  executed  once  (in  the  first  run).  Similarly  RESTART ed  runs 
remember  the  shadowing  table  from  the  previous  run.  HIDCEL  plots  a 
3D-VIEW  (6.6.1)  of  the  object  from  the  sun  position  each  time  it  is 
called,  either  explicitly  by  the  user,  or  by  other  modules  (TANK, 

SPIN,  ROTATE). 

A summary  of  HIDCEL  operations  is  given  in  Figure  8.1. 

8.2  ROTATE 

The  module  ROTATE  is  a utility  designed  to  simulate  the  rotation 
of  a spacecraft  in  sunlight.  It  is  used  with  multiple  calls  to 

TRILIN.  ROTATE  is  executed  between  calls  to  TRILIN  by  including  the 
card 

ROTATE  <n> 

in  the  NASCAP  runstream.  ROTATE  expects  to  find  two  cards  in  the  user 
input  file  n.  There  is  no  default  value  for  n and  n = 5 is  most 
commonly  used.  The  two  cards  following  ROTATE  in  the  NASCAP  runstream 
are  then  read  as  ROTATE  input.  A segment  of  a NASCAP  runstream  using 
ROTATE  has  the  general  form: 
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1.  HIDCEL  calculates  geometrical  shadowing  factors 
for  each  surface  cell  (shadowing  table). 

2.  Shadowing  table  stored  as  'AREAS'  and  'BSHAD1  in 
File  21. 

3.  Precedence:  HIDCEL  must  be  preceeded  by  OBJDEF  and 

logically  preceeds  TRILIN. 

4.  If  SUNINT  / 0,  then  either  HIDCEL  must  be  called  or 
CONVEX  be  specified  as  a run  option. 

5.  Each  new  choice  for  SUNDIR  must  be  followed  (for  non- 
CONVEX  objects)  by  a new  call  to  HIDCEL. 

6.  HIDCEL  plots  the  view  of  the  object  from  the  "sun" 
position. 

7.  HIDCEL  uses  no  input  file. 


Figure  8.1.  HIDCEL  summary. 


TRILIN 
ROTATE  5 


x y z 
TRILIN 
ROTATE  5 


x y z 
TRILIN 


The  first  card  that  ROTATE  expects  to  find  contains  the  angular 

velocity  vector  (in  rad  s ) <■>  w ® . The  second  contains 

x y z 

the  initial  sun  direction  for  cycle  11  Obviously  this  remains  the 
same  for  all  further  TRILIN  cycles.  For  example,  the  sequence: 


TRILIN 

ROTATE  5 

0.2  0.0 

0.0 

0.0  1.0 

0.0 

TRILIN 

ROTATE  5 

0.2  0.0 

0.0 

0.0  1.0 

0.0 

simulates  an  object  rotating  about  the  X axis  at  0.2  radians  per 
second  (1.9  rpm),  beginning  with  the  sun  direction  lying  along  the  Y 
axis  (in  the  positive  sense).  An  initial  call  to  TRILIN  (before  any 
call  to  ROTATE)  is  required  to  establish  the  elapsed  time  (usually 
equal  to  DELTA  (6.2.2)  - but  see  (6.2.6)).  The  subsequent  call  to 
ROTATE  changes  the  sun  direction  vector  and  the  magnetic  field  vector 
to  simulate  the  rotation  of  the  object  by  the  elapsed  time  times  the 
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magnitude  of  its  angular  velocity.  In  our  example  above,  if  the  first 
call  to  TRILIN  increased  the  elapsed  time  to  5 seconds,  then  the  sun 
direction  vector  will  be  rotated  from  0 1 0,  about  the  X axis  by  5 x 
0.2  = 1.0  radian.  The  next  call  to  TRILIN  will  then  take  place  with 
the  rotated  sun  direction  vector  (0  -0.54  -0.84)  and  so  on. 

Of  course,  changing  the  sun  direction  vector  must  always  be 
accompanied  by  a new  call  to  HIDCEL.  ROTATE  automatically  calls 
HIDCEL  to  establish  a new  shadowing  table  (8.1)  unless  the  option 
CONVEX 

has  been  included  in  the  run  options  file.  Further  calls  to  TRILIN 
without  any  more  calls  to  HIDCEL,  SPIN  or  ROTATE  will  use  the  last 
shadowing  table  created  by  ROTATE. 

If  the  number  of  cycles  chosen  for  each  call  to  TRILIN  (NCYC 
6.2.7)  is  greater  than  one,  the  same  shadowing  table  will  be  used  for 
each  cycle,  until  ROTATE  is  called  again.  This  will  lead  to 
significant  errors  unless  the  timestep  is  much  shorter  than  the 
rotation  period.  When  simulating  rotation  NCYC  should  usually  be  one. 

ROTATE  should  always  be  called  after  any  call  to  TANK  (See 
Section  8.1) . 

ROTATE  can  be  used  to  simulate  rotation  in  an  anisotropic  plasma 
environment  (whether  there  is  sunlight  present  or  not),  since  the 
direction  of  the  aligned  flux  component  (the  magnetic  field  direction) 

is  also  rotated. 

The  calls  ROTATE  makes  to  HIDCEL  generate  the  appropriate  plots 
(see  8.1) . 
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Finally,  omission  of  any  file  number  in  the  call  to  ROTATE 
causes  <ux  u>z  and  x y z to  be  set  at  the  default  values,  i.e., 

angular  velocity  = “x  » “z  0 0 2ir/60 
(1  rpm  about  the  Z axis) 

x y z 10  0 

(Initial  sun  direction  along  the  X axis) 

For  example 

TRILIN  TRILIN 

ROTATE  5 ROTATE  5 

TRILIN  0 0 2ir/60 

10  0 
TRILIN 

A summary  of  ROTATE  is  given  in  Figure  8.2. 

8.3  SPIN 

The  module  SPIN  creates  a shadowing  table  (8.1)  based  on  the 
average  illumination  of  each  surface  cell  over  one  rotation  period. 
The  card: 

SPIN  <n> 

included  in  the  NASCAP  runstream  will  execute  module  SPIN.  SPIN 
should  preceed  a call  to  TRILIN  intended  to  simulate  charging  of  an 

object  averaged  over  a rotation.  (Exact  precedence  is  summarized  in 
Table  2.2.) 

Like  ROTATE  (8.2)  SPIN  expects  to  find  two  input  cards  in  file 
n.  n has  no  default  and  n = 5 is  most  commonly  used.  In  this  case, 
SPIN  looks  for  the  next  two  cards  in  the  NASCAP  runstream  as  input.  A 
segment  of  the  runstream  calling  SPIN  has  the  general  form: 
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1.  ROTATE  simulates  rotation  of  an  object  in  sunlight 
and/or  an  anistropic  flux. 

2.  Unless  CONVEX  is  specified  in  the  options  file 
ROTATE  calls  HIDCEL  and  creates  a new  shadowing  table. 

3.  Precedence:  ROTATE  must  be  preceeded  by  TRILIN  and 

logically  preceeds  a second  call  to  TRILIN. 

4.  ROTATE  reads  two  cards  from  file  n,  e.g.  for  n = 5 
ROTATE  5 

“x  “y  "z  angular  velocity  vector  (rad/5) 

x y z initial  sun  direction  at  the 

beginning  of  cycle  1. 

5.  NCYC  should  usually  be  1. 

6.  Calls  to  ROTATE  should  follow  calls  to  TANK. 


Figure  8.2.  ROTATE  summary. 
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SPIN  5 
num 


x y z 
TRILIN 


# 

The  first  card  read  by  SPIN: 

'num' 

defines  the  number  of  views  of  the  object  to  be  included  in  the 
rotational  average.  The  second  card: 
x y z 

defines  the  orientation  of  the  spin  axis.  For  example 
SPIN  5 
4 

0 1 0 

calls  for  4 views  to  be  included  in  the  average  for  rotation  about  the 
Y axis.  The  initial  direction  of  the  sun  with  respect  to  the 
satellite,  or  the  first  view,  is  defined  by  the  'SUNDIR'  option, 

included  in  the  options  file  (Section  6.4.10).  For  example,  including 
the  card 

SUNDIR  101 

in  the  option  file  (IKEYWD)  defines  the  initial  view  to  be  in  the  XZ 
plane  at  an  angle  of  45°  from  the  positive  X axis  (i.e.,  between  the 
positive  X and  Z axes).  The  remaining  three  views  in  our  example  are 
generated  by  rotating  the  sun  direction  vector  by  2ir/num  (=  2*/4  = 
ir/2)  and  making  a fresh  call  to  HIDCEL  for  each  time.  The  final 
average  will  therefore  be  over  the  shadowing  factors  for  the  four 
orientations  45°,  135°,  225°,  315°  in  the  XZ  plane.  If  num  had  been 
chosen  to  be  3 then  the  three  views  would  have  been  from  angles  45*, 

165  , 285  , and  so  on.  The  shadowing  table  generated  by  SPIN  differs 
from  that  generated  by  HIDCEL  and  ROTATE  since  the  contribution  made 
by  the  angle  e between  the  surface  normal  and  the  sun  direction  is 
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included.  Recall  from  8.1,  this  contribution  is  added  later  by  TRILIN 
for  HIDCEL  and  ROTATE,  and  the  shadowing  table  contains  only 
geometrical  shadowing  factors.  Hence,  if  the  object  is  defined  as 
CONVEX 

in  the  options  file  (6.4.2)  a shadowing  table  is  still  compiled  by 
SPIN,  containing  the  average  of  cos  e over  the  "num"  views  for  each 
cal  1 . 


The  maximum  number  of  views  possible  is  25.  The  greater  the 
number  specified,  the  more  accurate  the  average.  For  typical  objects, 
eight  views  is  usually  sufficient. 

If  no  file  number  is  included  in  the  call  to  SPIN,  the  default 
values  of  the  input  parameters  are  used.  For  example,  the  cards 


SPIN 

TRILIN 


in  the  NASCAP  runstream  will  lead  to  a potential  calculation,  using  a 
shadowing  table  that  is  an  average  of  eight  views  (the  default  value 
of  "num")  about  the  Z axis  (the  default  rotation  axis). 

SPIN  and  ROTATE  (8.2)  differ  in  the  way  they  model  charging  of 
an  object  rotating  in  sunlight.  Often  the  part  of  the  object  in 
shadow  charges  negatively,  while  the  sunlit  part  remains  close  to 
neutral,  or  is  charged  less,  because  of  photoemission.  Thus  the 
potential  of  a particular  surface  cell  will  tend  to  oscillate  up  and 
down  with  the  rotation  frequency,  as  it  moves  in  and  out  of  the  sun. 
This  oscillatory  potential  can  only  be  modeled  with  ROTATE,  i.e., 
ROTATE  is  able  to  resolve  charging  behavior  on  a timescale  less  than  a 
rotation  period.  SPIN,  on  the  other  hand,  models  the  average 
behavior,  i.e.,  behavior  on  a timescale  longer  than  a rotation 
period.  Its  results  are  valid  therefore  only  if  charging  occurs  on  a 
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timescale  larger  than  a rotation.  For  spacecraft  spinning  slower  than 
they  charge,  ROTATE  should  be  used. 

Like  ROTATE  and  HIDCEL,  calls  to  SPIN  should  follow  calls  to 
TANK  (see  Section  5.9.1).  Following  a call  to  SPIN,  the  CONVEX 
keyword  should  be  omitted  from  the  runstream  input. 

A summary  of  SPIN  use  is  given  in  Figure  8.3. 

8.4  IPS 

Module  IPS  (Initial  Potential  Specification)  allows  you  to  set 
the  initial  potentials  of  both  conductors  and  insulators  (dielectrics) 
to  any  value.  Without  the  use  of  IPS  all  initial  potential  are 
assumed  to  be  zero.  IPS  should  always  be  used  when  FIXP  and/or  BIAS 
determine  non-zero  initial  potentials.  IPS  should  precede  a call  to 
TRILIN  and/or  DETECT.  Calls  to  TRILIN  following  IPS  in  the  same  run 
are  automatically  RESTARTed  (6.2.9)  at  cycle  1.  If  TRILIN  is  to  be 
executed  in  a subsequent  and  separate  run,  a RESTART  card  must  be 
explicitly  placed  in  the  options  file  by  the  user.  (Exact 
precedence  is  summarized  in  Table  2.2).  The  card 
IPS  <n> 

in  the  NASCAP  runstream  executes  module  IPS.  The  file  number  n is 
optional  and  defines  the  file  in  which  IPS  expects  to  find  its  input 
cards.  The  default  is  5,  in  which  case  IPS  looks  for  input  following 
immediately  in  the  NASCAP  runstream.  IPS  is  able  to  interpret  eight 
types  of  potential  specification  cards  as  input.  These  are: 

ALL  matl  v 
BOOM  i v 
BOOM  CELL  v 
DARK  matl  v 
END 

PCOND  i v 
POTENTIAL  v 
SUNLIT  matl  v 
SURFACE  CELL  v 

We  examine  each  of  these  in  turn. 
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SPIN  simulates  the  average  behavior  of  an  object 
rotating  in  sunlight. 

Unless  CONVEX  is  specified  as  a run  option  SPIN 
calls  HIDCEL  for  each  view  requested.  Following 
SPIN,  CONVEX  should  be  deleted  from  the  runs  ream 

input. 

Precedence:  SPIN  must  be  preceeded  by  OBJDEF  and 

logically  preceeds  TRILIN. 

SPIN  reads  two  cards  from  file  n (e.g.,  n = 5) 

ngn)N  5 number  of  views  about  spin  axis  included 
in  the  average, 
x y z spin  axis  direction. 

SPIN  creates  a shadowing  table  by  averaging  the  tables 
created  for  each  of  num  views  defined  .ec*ufl^ 
spaced  rotations  from  the  initial  sun  direction 
(SUNDIR)  about  the  axis  x y z.  Angle  effects  are 
included.  (8.3) 

Calls  to  SPIN  should  follow  calls  to  TANK. ___ 


Figure  8.3.  SPIN  summary. 
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8.4.1 


PCOND 


The  card: 

PCOND  1 v 

sets  the  potential  of  conductor  number  j to  v volts.  All  of  the 
overlying  surface  cells  are  also  set  to  potential  v,  and  any 
^ ^®**ential  charging  is  eliminated.  For  example 
PCOND  2 -1000 

sets  the  conductor  number  2,  and  all  surface  cells  associated  with 
conductor  2 to  -1000  volts. 

8.4.2  SURFACE  CELL 

The  card 

SURFACE  CELL  i v 

sets  the  potential  of  insulating  surface  cell  number  i to  v volts. 

The  surface  cell  number  is  the  same  as  that  previously  assigned  by 
OBJDEF  (3.10).  For  example: 

SURFACE  CELL  32  -800 

sets  the  potential  of  insulating  cell  32  to  -800  volts. 

If  the  surface  cell  chosen  is  not  an  insulator  IPS  prints  a 
reminder  of  this  fact  and  ignores  the  request. 

8.4.3  BOOM  CELL 

The  card 

BOOM  CELL  i v 

sets  the  potential  for  insulating  BOOH  cell  1 to  v volts.  It  works  in 
exactly  the  same  as  SURFACE  CELL  (8.4.2)  Indeed  it  is  formally 
equivalent  to: 

SURFACE  CELL  nsurf+i  v 

where  nsurf  is  the  number  of  non-boom  surface  cells.  For  example, 
suppose  there  are  300  non-boom  cells  on  an  object,  and  you  wish  to  set 
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the  fifth  boom  cell  to  -200  V.  This  can  be  achieved  with  the  card 
BOOM  CELL  5 -200 

or  equivalently  with 

SURFACE  CELL  305  -200 


8.4.4  BOOM 

The  card: 

BOOM  i v 

sets  all  insulating  cells  on  BOOM  i to  potential  v volts.  The 
underlying  conductor  is  unaffected.  For  example,  the  card 
BOOM  4 -4000 

sets  all  insulating  cells,  on  the  4th  BOOM  to  appear  in  the  object 
definition  file  (3.5),  to  -4000  volts. 

8.4.5  ALL,  DARK,  SUNLIT 


The  card 

ALL  matl  v 

sets  all  the  surface  cells  of  insulating  material  'matl'  to  v volts. 
Attempts  to  set  the  potentials  of  conducting  materials  (those  with 
property  3 equal  to  -1  (4.3.3))  with  this  command  are  ignored  and  a 
warning  message  is  printed.  For  example,  the  card 
ALL  KAPTON  -1000 

sets  all  cells  with  surface  material  Kapton  to  -1000  volts.  The  card 
ALL  GOLD  -1000 

is  ignored  since  gold  is  a metallic  conductor  (if  its  properties  are 
properly  defined!).  The  two  subsets  of  those  cells  in  shadow  and 
those  cells  in  sunlight  can  be  set  independently  using  the  cards 
DARK  matl  v 


and 


SUNLIT  matl  v 
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For  example,  the  card 

DARK  KAPTON  -1000 

will  set  only  the  KAPTON  cells  that  are  in  shadow  to  -1000  volts. 
Partially  shadowed  cells  (i.e.,  those  with  illumination  greater  than 
zero)  are  considered  sunlit. 

8.4.6  POTENTIAL 

The  card 

POTENTIAL  v 

can  be  used  to  set  any  string  of  cells  to  a potential  v.  Immediately 
following  this  card,  a second  card  gives  the  cell  numbers  to  be  set. 
Further  cards  may  also  follow.  Up  to  15  cell  numbers  may  be  written  on 
each  card.  IPS  will  continue  to  read  cards  until  an  'END'  is  found  in 
place  of  a cell  number.  For  example 
POTENTIAL  -500 
1 3 6 25  7 8 

101  512  613  26  27 

17  21  END 

sets  the  potential  of  cells  1,  3,  6,  25,  7,  8,  101,  512,  613,  26,  24, 
17,  and  21  to  -500  volts.  (This  is  a particularly  useful  feature  to 
use  with  the  TERMTALK  subset  capabil  ity 

8.4.7  END 

The  'END'  card  terminates  input  to  the  IPS  module. 

8.4.8  ' F IXP ' AND  'BIAS'  CARDS 

The  run  options  FIXP  and  BIAS  (see  6.3.5  and  6.3.1)  fix  the 
potential  of  a conductor  and  bias  it  relative  to  conductor  1 
respectively. 


These  potentials  are  initially  implemented  in  the  IPS  module, 
and  will  be  re -implemented  by  any  subsequent  TRILIN  call.  However,  it 
is  possible  to  conflict  with  these  specifications  using  the  PCOND 
command.  The  following  rules  should  be  observed: 

• Potentials  of  fixed  conductors,  or  mutually  biased  systems 
of  fixed  conductors,  should  be  specified  only  in  the 
options  file. 

• Potentials  of  floating  conductors  should  be  specified  only 
in  the  IPS  file. 

• If  conductor  1 is  at  zero  potential,  potentials  of 
conductors  biased  to  it  should  not  be  specified  in  the  IPS 
file. 

• If  conductor  1 is  floating  at  non-zero  potential, 
potentials  of  conductors  biased  to  it  should  be 
individually  specified  in  the  IPS  file. 

8.4.9  IPS  Files 

A typical  file  read  by  IPS  might  have  the  form 

BOOM  2 -1000 
ALL  KAPTON  -2000 
DARK  TEFLON  -2500 
DARK  KAPTON  -1638 
POTENTIAL  -1770 
1 180  223  6 END 

END 

This  file  sets  all  the  insulating  cells  on  the  second  boom  defined  to 
-1000  volts.  All  Kapton  cells  are  set  to  -2000  volts.  If  some  of  the 
boom  cells  are  Kapton,  the  previous  assignment  of  -1000  V will  be 
overridden  by  the  latest  assignment  of  -2000  V. 
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Dark  Teflon  and  Kapton  cells  are  set  to  -2500  and  -1638  V 
respectively.  Again,  any  duplicate  assignments  are  overridden  with 
the  latest  assigned  value.  Thus  all  dark  Kapton  cell  potentials  are 
assigned  -1638  V rather  than  -2000  V. 

Finally,  cells  1,  180,  223,  and  6 are  set  to  -1770  volts.  Note 
that  the  cell  number  list  is  terminated  with  an  ‘END1,  as  is  the 
entire  file  (with  a second  'END'). 

Potential  assignments  made  using  IPS  are  not  remembered  by 
subsequent  IPS  calls.  IPS  zeroes  potentials  not  specified  by  FIXP  or 
BIAS  before  beginning  with  its  own  assignments. 

The  IPS  input  commands  are  sunmarized  in  Figure  8-4. 

8.5  CAPACI 

Module  CAPACI  calculates  the  capacitance  of  the  whole  object, 
the  individual  conductors,  and  surface  cells  to  infinity.  In  addition 
it  calculates  the  capacitances  between  the  different  parts  of  the 
spacecraft.  This  information  is  all  stored  in  file  ICN0W(21) 

(Table  2.6). 

CAPACI  is  usually  executed  after  0BJDEF.  It  must  be  executed 
before  TRILIN  or  IPS,  since  TRILIN  uses  the  capacitance  information 
stored  in  file  21. 

No  user  input  is  normally  required  for  CAPACI.  However,  if 
DEBYE  (6.4.3)  is  specified  as  a run  option,  CAPACI  reads  the  plasma 
environment  information  from  the  IFLUX  file.  The  IFLUX  file  is  then 
read  again  later  by  TRILIN  in  the  normal  way. 
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PCOND  i 


Set  conductor  2 and  a11  overlying  surfacea  cells  to 
potential  2* 

SURFACE  CELL  i v 

Set  insulating  surface  cell  to  potential  2* 

BOOM  CELL  i v 

Set  the  it*1  boom  cell  to  potential  v.  (Equivalent 

to  SURFACE  CELL  [NSURF  + i]  v). 

BOOM  i v 

Set  all  insulating  cells  on  BOOM  2 to  potential  2* 
(Does  not  set  underlying  conductor.) 

ALL  matl  v 

DARK  matl  v 

SUNLIT  matl  v 

Sets  all  cells  of  material  mat!  to  potential  2* 
Variants  allow  only  dark  or  only  sunlit  cells  to  be 
set. 

POTENTIAL  v 

Si  S2  ...  END 

Set  a list  of  surface  cells  to  potential  2* 
appears  on  subsequent  cards,  with  up  to  fifteen 
numbers  per  card.  Processing  continuers  until  END  is 
encountered  in  place  of  a cell  number.  (The  TERMTLK 
SUBSET  capabilities  might  be  used  to  generate  such  a 

list.)C20] 

END  (or  @E0F ) 

Conclude  keyword  processing 


Figure  8.4.  IPS  input  commands. 
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8.6  NEWMAT 


The  module  NEWMAT  allows  the  properties  of  a material  (Chapter 
4)  to  be  changed,  without  re-defining  the  whole  object  using  OBJDEF 
(Chapter  3)  again.  The  19  properties  that  characterize  each  material 
are  initially  defined  during  the  execution  of  OBJDEF.  NEWMAT  is  most 
often  used  to  change  some  of  the  properties  in  a subsequent  run,  prior 
to  a new  call  to  TRIIIN.  (The  exact  precedence  of  NEWMAT  is 
summarized  in  Table  2.2.)  NEWMAT  is  executed  by  including  the  card 
NEWMAT  n 

in  the  NASCAP  runstream.  The  parameter  n specifies  the  number  of  the 
file  where  NEWMAT  expects  to  find  its  input  parameters.  Usually  n = 5 
is  chosen  so  that  NEWMAT  reads  the  next  four  cards  in  the  NASCAP 
runstream  as  input. 

For  example,  the  cards: 


NEWMAT  5 
KAPTON 

3.5  0.000127  l.E-16  5.  2.1  0.15  71.48  0.60 

312.1  1.77  0.455  140.  0.00002  l.E+16  15.  16. 

1 . E— 13  1.  l.E+3  20. 

ENO 

included  in  the  NASCAP  runstream  redefine  the  KAPTON  material 
properties  to  the  values  given  on  the  cards.  The  format  for  input  of 
material  properties  for  NEWMAT  is  exactly  the  same  as  in  OBJDEF 
(4.4).  The  completed  list  of  materials  and  properties  must  be 
terminated  by  an  'END'  card.  (Otherwise  NEWMAT  will  assume  that  all 
further  cards  in  the  runstream  are  new  material  names.)  For  example, 
if  two  materials  are  to  be  re-defined,  the  relevant  part  of  the 
runstream  might  have  the  form: 
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NEWMAT  5 

{KAPTON 

{3  parameter  cards  (4.4) 

GOLD 

(3  parameter  cards  (4.4) 

END 

TRILIN 

END 

There  are  two  restrictions  in  the  use  of  NEWMAT: 

1.  The  names  of  materials  cannot  be  changed,  or  new  material 
names  introduced. 

2.  The  values  of  the  bulk  conductivity  and  surface  conductivity 
(properties  3 and  14)  may  not  be  changed  so  that  the 
material  changes  from  an  insulator  to  a metallic  conductor 
or  visa  versa,  or  from  a surface  non-conductor  to  a surface 
conductor.  In  other  words,  the  values  of  properties  3 and 
24  may  not  be  changed  from  positive  values  to  negative 
values  or  vice  versa. 

Changing  the  sign  of  properties  3 and  14  cause  changes  in  the  structure 
of  conductivity  matrices  rather  than  their  value,  and  OBJDEF  must  be 
re-executed  in  these  cases. 

Note  that  the  capacitances  of  the  object  brought  about  by 
changes  in  material  properties  are  automatically  accounted  for  by 
NEWMAT,  and  no  subsequent  re-execution  of  CAPACI  is  necessary. 
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8.7  SATPLT 


Module  SATPLT  requires  no  direct  user  input,  and  causes 
three-dimensional  views  of  the  object  to  be  plotted,  along  with 
two-dimensional  maps  of  the  pattern  of  surface  materials. 

The  nature  of  the  views  and  maps  are  determined  using  the  run 
options  30-VIEW  (6.6.1)  and  MATVIEW  (6.6.4)  respectively.  If  no  views 
are  specifically  requested  using  this  option,  the  default  views 
discussed  in  6.6.1  and  6.6.4  are  produced.  SATPLT  is  usually  called 
after  OBJDEF  as  an  aid,  to  see  if  the  object  we  had  in  mind  is 
actually  the  object  we  defined  (or  to  see  if  they  at  least  look  the 
same).  The  exact  precedence  is  summarized  in  Table  2.2.  The  card: 
SATPLT 

included  in  the  runstream  executes  SATPLT.  Examples  of  the  plots 
produced  are  given  in  Chapter  9. 

8.8  STRESS 

The  module  STRESS  is  used  to  determine  the  surface  cells  with 
internal  electric  fields  of  greatest  magnitude.  The  internal  electric 
field,  or  stress,  E$tress  is  defined  as 

E 

stress  “ d 

where  V is  the  potential  of  the  underlying  conductor,  is  the 
potential  of  the  dielectric  surface  and  d is  the  thickness  of  the 
dielectric  surface  layer.  The  greater  this  stress  field,  the  more 
likely  a dielectric  breakdown  or  "punchthrough"  will  occur.  (See 
6.3.3  discussing  the  NASCAP  DISCHARGE  analysis.) 

STRESS  is  executed  by  including  the  card 
STRESS  <m> 
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in  the  NASCAP  runstream,  usually  after  a call  to  TRILIN.  (Exact 
precedence  is  summarized  in  Table  2.2.)  The  only  input  parameter  is 
the  optional  quantity  m.  m is  the  number  of  cells  to  be  reported  by 
STRESS.  For  example,  the  card 
STRESS  10 

will  cause  the  10  cells  with  the  greatest  stress  to  be  identified  in 
descending  order  of  stress  field.  Omission  of  <m>  causes  an  cells  to 
be  listed  in  descending  order  of  stress. 

For  each  cell  included  in  the  list  generated  by  STRESS,  the 
value  of  its  stress  field  and  its  cell  number,  along  with  its  surface 
material,  normal,  vertex,  and  other  identifying  information,  is 
printed  out. 
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9.  GRAPHICAL  OUTPUT 


Graphical  output  is  a key  component  in  the  presentation  and 
interpretation  of  NASCAP  results.  The  plotting  protocol  is  designed 
to  be  easily  interfaced  to  any  system’s  graphics  library.  The  plots 
appear  in  four  colors  (black,  red,  green,  blue)  when  plotted  on  color 
hardware.  The  types  of  plots  produced  are  (1)  object  illustration  and 
shadowing  plots;  (2)  contour  plots;  (3)  particle  trajectory  plots; 
and  (4)  detector  plots. 

9.1  OBJECT  ILLUSTRATION  AND  SHADOWING  PLOTS 

Object  illustration  plots  are  produced  by  the  SATPLT  module 
(or  the  interactive  OBJCHECK  object  definition  program). Three 
types  of  plots  are  produced:  material  plots,  3-D  plots  without  hidden 

line  elimination,  and  3-D  plots  with  hidden  line  elimination 
(shadowing  plots). 

9.1.1.  MATERIAL  PLOTS 


Material  plots  (Figures  9. 1-9. 2)  are  designed  to  show  the 
placement  of  materials  on  the  object.  Each  of  the  fifteen  materials 
is  shown  with  different  shading  and  (on  appropriate  hardware) 
different  colors.  (Materials  1,  5,  9,  13  are  in  black;  2,  6,  10,  14 
in  red;  3,  7,  11,  15  in  green;  and  4,  8,  12  in  blue.)  By  default, 
six  plots  are  generated  showing  the  view  from  each  coordinate 
direction.  The  MATVIEW  keyword  (6.6.4)  may  be  used  to  expose  surfaces 
which  would  otherwise  be  hidden  (Figure  9.3). 

9.1.2.  3-D  PLOTS 


Two  types  of  3-D  object  plots  are  available.  The  first  type 
(Figure  9.4),  plotted  only  by  SATPLT  (or  OBJCHECK),  plots  the  outline 
of  the  large  blocks  (RECTAN,  OCTAGON,  etc.)  projected  on  a plane 
normal  to  the  view  direction  without  hidden  line  elimination.  Booms 
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SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWEO  FROM  THE  POSITIVE  T DIRECTION 
FOR  t VALUES  BETWEEN  1 AND  17 

MATERIAL  LE6ENO 


Figure  9.1. 


Material  plot  of  an  object  consisting  of  five  dumbbells 
All  fifteen  shading  patterns  are  illustrated. 
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SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWED  FROM  THE  POSITIVE  X DIRECTION 
FOR  X VALUES  BETWEEN  1 AND  9 

MATERIAL  LEGENO 


1 

MOO! 


Figure  9.3. 


Material  plot  view  of  surfaces  which  were  hidden  in 
Figure  9.2. 
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are  omitted  from  this  plot.  The  second  type  (Figure  9.5)  plots 
individual  surface  cells  and  boom  surfaces  with  hidden  lines 
eliminated.  This  type  of  plot  is  also  produced  by  calls  to  the 
HIDCEL,  SPIN,  ROTATE  and  TANK  modules.  The  plots  are  from  the 
perspective  of  a viewer  1000  mesh  units  distant,  except  that  the  TANK 
module  places  the  viewer  at  the  gun  positions.  On  appropriate 
hardware,  the  shadowing  plots  are  color-coded  by  material  (as  on  the 

material  plots). 

9.2  CONTOUR  PLOTS 

Contour  plots  are  produced  by  various  portions  of  the  TRILIN 
module.  The  quantity  whose  contours  are  most  commonly  plotted  is  the 
electrostatic  potential.  (This  may  also  by  plotted  by  the  interactive 
POTPLT  program. C20])  In  addition,  contours  of  space  charge 
(calculated  by  the  SHEATH  option),  and  of  current  density  (calculated 
by  the  TYPE  1 test  tank)  may  be  plotted.  Contour  plots  include  a 
"silhouette"  of  the  test  object. 

9.2.1  ELECTROSTATIC  POTENTIAL  CONTOURS 

Contours  of  electrostatic  potential  in  a plane  normal  to  one 
of  the  coordinate  axes  will  be  plotted  on  request.  Frequency  and 
location  of  plots  may  be  controlled  through  the  CONTOURS  keyword 
(6.6.2).  Each  plot  is  captioned  as  to  cycle  number,  time,  location, 
and  contour  levels  (volts).  (The  interactive  POTPLT  program  also 
allows  control  over  number  of  contours.)  A potential  contour  plot 
example  is  shown  in  Figure  9.6. 

It  should  be  noted  that  "exact  zeros"  in  the  interior  of  the 
potential  array  are  assumed  interior  to  the  object  and  are  set  at 
conductor  1 potential.  This  has  proved  a good  procedure  in  the  vast 
majority  of  cases.  The  user  must  be  aware  that  the  contour  lines 
inside  the  object  do  not  exist  and  should  be  expunged  before 
presentation. 
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Figure  9. 


. The  view  of  Figure  9.4  after  hidden  line  elimination. 
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Z AXIS 


SIXW  z 


POTENTIAL  CONTOURS  ALONG  THE  T-2  PLANE  OP  X - 0 


ZMN  - -l.OOOO+OOl  ZMflX  - 1.0300+001  DZ  - 1.0000+000 


(b) 


Figure  9.6.  Electrostatic  potential  contours  about  an  object  composed 

of  two  spheres.  The  lower  sphere  is  at  +10  V and  the  upper 
at  -10  V.  (a)  One-grid  plot;  (b)  Two-grid  plot. 
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9.2.2.  CHARGE  DENSITY  CONTOUR  PLOTS 


Space  charge  density  associated  with  low  energy  emitted 
electrons  (i.e,,  secondary  electrons  and  photo-electrons),  is  plotted 
by  the  TRILIN  module  when  the  keyword  SHEATH  is  included  in  the 
options  file  (6.6.6).  The  contour  levels  are  in  coul/m  . An 
example  is  shown  in  Figure  9.7a.  The  example  is  for  the  same  case  as 
Figure  9.6;  most  of  the  low-energy  electrons  result  from  sunlight 
incident  from  the  +Y  direction.  Note  that  the  charge  density  near  the 
positive  (lower)  sphere  is  about  double  that  near  the  negative  (upper) 
sphere.  The  reason  is  seen  in  the  accompanying  particle  trajectory 
plot,  which  shows  electrons  repelled  from  the  negative  sphere,  but 
forming  a cloud  around  the  positive  sphere. 

9.2.3  CURRENT  DENSITY  CONTOUR  PLOTS 

Current  density  contour  plots  from  the  TYPE  1 test  tank  may 
be  requested  using  the  TANKCUR  keyword.  The  plots  give  the 
Z-component  of  current  (A/m2)  projected  onto  the  "sample  plane". 
Examples  are  shown  in  Figures  9.8d-f. 

9.2.4.  CONTOUR  PLOT  RESOLUTION  ERRORS 

Contour  plots  are  performed  using  strai ghtforward  bilinear 
interpolation.  Near  object  surfaces,  this  is  a far  cruder  model  than 
is  used  internally  in  NASCAP  (for  potential  calculations,  particle 
tracking,  and  electrostatic  field  calculation).  In  interpreting 
contour  plots  the  user  should  be  aware  of  these  shortcomings. 

Some  of  these  errors  are  shown  in  Figure  9.6.  We  have 
previously  mentioned  that  the  conductor  1 potential  (+10V  in  this 
case)  is  inserted  for  potentials  interior  to  the  object.  This  results 
in  contour  lines  interior  to  the  upper  (-10V)  sphere.  Also,  the 
contours  exterior  to  the  upper  sphere  are  in  error  near  the  slanted 
surfaces.  NASCAP  understands  the  potential  at  the  midpoint  of  the 
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slanted  line  to  be  -10  V;  however  its  bilinearly  interpolated  value 
is  about  -4V.  (This  error  is  not  apparent  for  the  lower  sphere 
because  the  interpolation  error  is  less  than  the  contour  interval.) 

In  the  case  of  the  two-grid  plot  (Figure  9.6b),  the  mesh  point  density 
is  insufficient  to  resolve  the  object,  so  that  conclusions  may  be 
drawn  only  about  potentials  distant  from  the  object  surface. 

The  contour  routines  do  not  recognize  the  existence  of  double 
points.  Thus  the  potential  beneath  a thin  plate  will  appear  to  vary 
linearly  from  its  "top"  value  to  the  correct  value  one  grid  unit  below 


The  contour  routines  do  not  recognize  the  existence  of  thin 
booms.  Thus  the  potential  near  a boom  appears  to  vary  linearly  from 
the  boom  center  to  its  correct  value  one  grid  unit  away,  rather  than 
logarithmically  from  the  boom  surface. 

9.3  PARTICLE  TRAJECTORY  PLOTS 

Particle  trajectory  plots  are  produced  by  the  DETECT  module, 
and  within  the  TRILIN  module  by  the  TYPE  1 test  tank  (keyword 
TANKTRAJ),  SHEATH,  and  EMITTER  facilities.  The  DETECT  module  plots 
one  trajectory  for  each  value  of  the  independent  variable  for  each 
species  (Figures  9.9-9.10).  The  TYPE  1 test  tank  plots  trajectories 
for  all  particles  emitted  with  i = 0 or  it  (Figure  9.8a-c).  The  SHEATH 
routines  plot  trajectories  for  all  particles  emitted  from  surface 
cells  requested  for  output  (keyword  SURFACE  CELL  n)  (Figure  9.7b). 

The  EMITTER  routines  plot  the  trajectory  of  the  emitted  beam  (absent 
space  charge  effects)  (Figure  9.11). 

9.4  DETECTOR  PLOTS 

The  detector  plots  give  the  energy  flux  of  electrons  and  ions 
measured  by  a detector  as  a function  of  a specified  independent 
variable  (energy  or  angle).  Electrostatic,  magnetic  field,  and 
particle  shadowing  effects  are  taken  into  account.  Examples  are  shown 
in  Figure  9.12.  The  DETECT  module  is  more  fully  discussed  in 

Chapter  7. 
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TRAJECTORIES  AT  CYCLE  4 FOR  ELECTRONS  RECEIVED  BY  DETECTOR 
LOCATED  AT  CELL  number  CIS  PROJECTED  ONTO  1>C  Y-2  PLr*e 


Figure  9.9. 


Trajectories  for  electrons  received  at  25  different  detector 
energnes  logarithmically  spaced  from  10  eV  to  5ev?fl 
ducting  object  charged  to  -4.5  keV  and  no  magnetic  field* 


336 


N * 


TRAJECTORIES  AT  CYCLE  4 FOR  PROTONS  RECEIVED  BY  DETECTOR 
LOCATED  AT  CB l NUMBER  22S  PROJECTED  CttfTO  THE  Y-2  Pt-Af'C 


Y-AXIS 


Figure  9.10.  Trajectories  for  protons  received  at  25  different  detector 
energies  logarithmically  spaced  from  10  eV  to  50  keV.  (Con- 
ducting object  charged  to  -4.5  keV  and  no  magnetic  field.) 
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PARTICLE  TRAJECTORIES  AT  CYCLE  1 1 FROM  1 EMITTER* S>  PROJECTED  WTO  THE  Y-Z  FLAME 
<3  I LOCATION  A I®  EMITTER  TYPE:  225* E) 


-3 


Y-AXIS 


Figure  9.11. 


Conducting  object  potential  = +0.98  keV. 

Uniform  magnetic  field  = 0.1  gauss  along  -X  axis 
Plot  boundary  = grid  4. 

Mean  beam  energy  =1.1  keV. 

Beam  energy  spread  = 0.1  keV  (25  energies). 

Beam  angular  spread  = 0°. 

Electron  emission  current  = 1 MA. 

Highest  grid  which  particles  entered  = 6. 
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IMPLEMENTATION:  NASCAP*PLOTREAD 


The  main  program  NASCAP  does  not  contain  any  dependence  on 
the  user's  locally  implemented  graphics  library.  Rather,  NASCAP 
writes  a "neutral"  plot  file  (file  2)  consisting  of  subroutine  calls 
and  their  arguments.  (A  list  of  these  subroutines  appears  as  Table 
9.1.  NASCAP*PLOTREAD  contains  a main  program  which  reads  file  2 and 
reconstructs  the  subroutine  calls.  The  subroutines  of  NASCAP*PLOTREAD 
then  call  the  appropriate  user  graphics  library  routines. 

Versions  of  NASCAP*PLOTREAD  have  been  written  for  the  DISSPLA 
graphics  package  at  S-Cubed,  the  IGS  package  at  NASA/LeRC,  and  the 
PL0T*PL0T  package  at  Jet  Propulsion  Laboratory. 
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TABLE  9.1.  NASCAP-PSEUDO  GRAPHICS  SUBROUTINES 
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TABLE  9.1.  NASCAP  PSEUDO-GRAPHICS  SUBROUTINES  (Concluded) 
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10.  PRINTED  OUTPUT 


10.1.  INTRODUCTION 

The  output  printed  by  NASCAP  for  each  module  is  largely  self 
explanatory.  Some  lines  of  output  bear  directly  on  the  user  s 
problem,  while  others  serve  primarily  to  monitor  the  progress  of  the 
calculation.  Only  the  former  type  of  output  is  of  interest  to  the 
everyday  user  of  the  code.  In  this  section  we  provide  a quick 
reference  to  the  blocks  of  printed  output  produced  by  each  module. 


10.2  CAPACI 


Sample  output  from  module  CAPACI  is  shown  in  Figure  10.1. 
The  references  shown  are  as  follows: 


1.  The  inverse  of  the  PCOND  values  give  the  capacitance 

of  the  object  to  infinity  in  code  units.  The  code  unit 
of  capacitance  is  printed  out  by  RDOPT. 

2.  This  is  the  radius  of  a sphere  of  equivalent  capacitance. 

3.  These  are  the  stray  capacitances  between  higher  numbered 
conductors  and  conductor  1. 


The  remaining  output  is  for  diagnostic  purposes. 

***+**CAPACl 

POTENTIALS  TO  BE  SET  BY  SETALL  TO  1 .00*000/ I A*P 1*R » 

AVERAGE  RADIUS  1R0I  = M . 00*000  COOE  UNITS 


PCONO  = 
QCONO  = 


1 7 POTENTIAL  ITERATIONS  COHPLETEO. 

RDOTR/RDRMAX=  1.8S-009/  2.78-001 

2.0106-002  2.0 10fe-002 

7. 8S69-001  2.1 936-00 1 


VBAR:  2.005H-002  — CS  SCALED  BY  1.0026*000 

CROEEF  EFFECTIVE  OBJECT  RAOIUS  = .0791  HETERS 


PCONO  = 
QCONO  = 


SO  POTENTIAL  ITERATIONS  COMPLETEO. 

RD0TR/RDRNAX=  2.38-003/  3.82*005 

-2.1205*000  7.8795*000 

-3.5585*002  3.5S81«002 


SMALL  1NTERCONOUCTOR  CAPACITANCES: 

-2.73*001  2.72*001 


Figure  10.1.  CAPACI  output. 
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10.3 


DETECT 


Figure  10.2  shows  sample  DETECT  output.  The  references  are 
as  follows: 

1.  The  DETECT  input  file  is  echoed  and  interpreted. 

2.  The  definition  of  each  detector  is  sumnarized. 

3.  The  environment  description  read  from  IFLUX  is 
summarized. 

4.  The  energies  and  velocities  of  each  particle  tracked 
(for  ions  and  electrons)  are  listed.  Particles 
originating  from  the  spacecraft  are  not  included  in  the 
flux  collected  by  the  detector. 
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PARAMETER  OrriNITIOA  SUKMARV  FOR  PARTICLE  DETECTORS 
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Figure  10.2.  (Continued). 
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Figure  10.2.  (Continue- 
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Figure  10.2.  (Concluded). 


10.4. 


HIDCEL 


Output  is  shown  in  Figure  10.3.  The  output  is  purely 
diagnostic. 


•••♦••HIDCEL 
DISTANCE  EQUALS 

FINAL  NA1  S 6? 


999.99998 


Figure  10.3.  HIDCEL  output. 


10.5  IPS 

Sample  output  from  module  IPS  is  shown  in  Figure  10.4.  The 
references  are  as  follows: 

1.  The  IPS  input  cards  are  echoed. 

2.  The  potentials  in  space  are  set  to  the  monopole  potential 
with  the  radius  and  charge  given. 

3.  The  new  surface  cell  potentials  are  summarized. 

4.  Potentials  and  charges  on  the  conductors  are 
summarized. 
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Figure  10.4.  IPS  sample  output. 


10.6 


NEWMAT 


Sample  NEWMAT  output  is  shown  in  Figure  10.5.  References  are 
as  follows: 

1.  NEWMAT  input  is  echoed. 

2.  The  property  table  for  each  redefined  material  is 
printed. 
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Figure  10.5.  NEWMAT  sample  output. 


10.7. 


OBJDEF 


Sample  output  is  shown  in  Figure  10.6.  References  are  as 

follows: 

1.  The  object  definition  file  is  echoed  as  read. 

2.  Each  building  block  definition  is  confirmed  in  absolute 
grid  coordinates  (centered  at  9,  9,  (NZ+l)/2). 

3.  The  surface  cell  list  is  printed  (absolute  coordinates). 
IX,  IY,  IZ  are  the  coordinates  of  the  lowest  indexed 
vertex  of  the  associated  volume  element. 

4.  The  material  properties  are  summarized. 
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Figure  10.6.  OBJDEF. 
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Figure  10.6.  (Continued) 
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Figure  10.6.  (Continued). 
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Figure  10.6.  (Continued). 
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Figure  10.6.  (Continued) 
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Figure  10.6.  (Continued). 
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Figure  10.6.  (Continued). 
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Figure  10.6.  (Continued). 
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FNDSCE  — 328  SURFACE  CONDUCTING  EDGES  FOUND 
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668  ENTRIES  IN  REVISEO  VTXl 


10.8 


RDOPT 


Sample  output  is  shown  in  Figure  10.7.  References  are  as 

follows: 

1.  Option  file  input  cards  are  echoed. 

2.  In  UNI VAC  versions  temporary  files  are  automatically 
assigned. 

3.  A summary  of  all  options,  including  defaults,  is  printed. 
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Figure  10.7.  RDOPT 
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10.9 


ROTATE 


Sample  ROTATE  output  is  shown  in  Figure  10.8.  References  are 
as  follows: 

1.  The  time  elapsed  since  the  beginning  of  the  first  cycle 
is  printed. 

2.  The  sun  direction  vector,  following  rotation  of  the 
satellite  is  printed.  This  will  be  the  direction  for 
the  next  call  to  TRILIN. 


••♦•♦•ROTATE  S 

1 TIME  = 7.0920  SECONOS 


2 


SUM  ROTATED  TO  1.A101 

DISTANCE  E DUALS  999.99999 


FINAL  NA1  = 68 


•1077  .0000 


Figure  10.8.  ROTATE  sample  output. 


10.10.  SATPLT 


Sample  output  is  shown  in  Figure  10.9.  It  is  all  purely 
diagnostic. 


*«***«SATPLT 
ASGF1L  — 8ASG  2.  . 

01  STANCE  EQUALS  999.99998 

FINAL  NA1  = 95 

OISTANCE  EQUALS  999.9999S 

FINAL  NA1  = 95 

OISTANCE  EQUALS  999.99999 

FINAL  NA1  S 93 

Figure  10.9.  SATPLT  output. 
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10.11  SPIN 


Sample  SPIN  output  is  shown  in  Figure  10.10.  References  are 
as  follows: 

1.  The  normalized  sun  direction  vector  for  the  first  view  is 
printed. 

2.  The  number  of  views,  and  the  spin  axis  vector  are  echoed. 

3.  Each  line  represents  a call  to  HIDCEL.  In  this  case 
there  are  four  views  and  hence  four  calls. 


( 

( 


******SPIN  S 

AS6FIL  — MSG  2.  . 

AVERAGE  SOLAR  ILLUMINATION  BEING  OBTAINEO 

THE  INITIAL  SUN  DIRECTION  IS  .707 

A VIEWS  WILL  BE  GENERATED  ABOUT  THE  AXIS 
01  STANCE  EQUALS  999.99998 

FINAL  NA1  = 62 

DISTANCE  EQUALS  999.99999 

FINAL  NA1  2 62 

DISTANCE  EQUALS  999.99998 

FINAL  NAI  S 62 

DISTANCE  EQUALS  999.99999 


.707 


.000 


.000 


.000 


1.000 


FINAL  NAI  = 


62 


Figure  10.10.  SPIN  sample  output. 
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10.12.  STRESS 


Sample  STRESS  output  is  shown  in  Figure  10.11.  References 
are  as  follows: 

1.  The  number  of  cells  requested  (10)  is  echoed. 

2.  For  each  cell  in  order  of  decreasing  stress,  the 
potential,  stress  field  and  descriptive  information  is 
printed  out. 
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10.13.  TANK 


Sample  TANK  output  Is  shown  in  Figure  10.12.  References  are 
as  follows: 

1.  A message  is  printed,  showing  that  a shadowing  table 
exists  from  a previous  TANK  execution. 

2.  The  TANK  input  is  echoed. 

3.  Successful  definition  is  confirmed  for  each  of  the  four 
guns. 

4.  A fresh  call  to  HIDCEL  is  made  for  each  gun  to  create  a 
new  shadowing  table. 
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T AN*  S 


OBJECT  DEFINITION  INFORM* TI ON  BEING  PEAO  FRO-  FILE 

1 A SMAOO.ING  TABLE  WAS  PREVIOUSLY  GENERATED 
- FOR  THIS  OBJECT  USING  THE  GUNS  OPTION 
Z SUN  AT  0 16  16 
ENERGY  6 • KEV 
CURRENT  5.E-6 
BE AmuIOTm  30  OEGREES 
DIRECTION  0 -1  *1 
6uN  AT  9 -16  16 
ENERGY  6*  KEV 
CURRENT  5.E-6 
BEAnwIOTN  30  DEGREES 
OIRECTION  0 1 -1 


GUN  AT  0 -16  -16 
ENERGY  6 « KEV 
CURRENT  5.E-6 
BE AmuIOTm  30  OEGREES 
OIRECTION  Oil 
GUN  AT  C 16  -16 
ENERGY  6*  K£V 
CURRENT  5.E-6 
BEAHwIOTH  30  OEGREES 
OIRECTION  C -1  1 
ENO 

3 SUN  DEFINITION  

GUN  1 HAS  BEEN  DE  F I NE  0 AS  AN  ELECTRON  SUN 

GUN  IS  LOCATEO  AT  GRID  COORDINATES  9.CC  25.CC  2S.CC 

GUN  DIRECTION  IS  .00  -I. 00  *1.00 

BE*N  1:  ENERGY:  6.00*303  EV  CURRENT : S.30-0C6  AHPS  CUT-OFF  ANGLE*  2C.3CCC 

SUN  DEFINITION  — — - 
GUN  2 HAS  BEEN  OEFInED  AS  AN  ELECTRON  SUN 
SUN  IS  LOCATEO  AT  6RXG  COORDINATES  9.30  -7.CC  25. OC 

GUN  DIRECTION  IS  .00  1.03  -1.30 

BEAM  1:  ENERGY-  6.CG*C23  EV  CURRENT  r 5.30-CG6  AMPS  CUT-OFF  ANGLE  - 2C.3C0C 

6UN  DEFINITION  — — — 

GUN  3 HAS  BEEN  OEFInEO  AS  AN  ELECTRON  GUN 

GUN  IS  LOCATEO  AT  GRIO  COORDINATES  9. DC  -7.0C  -7.CC 

GUN  DIRECTION  IS  .00  I. 00  1.00 

BEAM  Is  ENERGY:  6.00*CC3  EV  CURRENT  : 5.00-CC6  AHPS  CUT-OFF  ANGLE  - 2C.3OG0 


GUN  DEFINITION — 

GUN  H HAS  BEEN  DEFINED  AS  AN  ELECTRON  GUN 

GUN  IS  LOCATED  AT  GRIO  COORDINATES  9.30  25.00  -7.00 

GUN  OIRECTION  IS  .OC  -l.OC  i.CC 

BEAM  1;  ENERGYX  6 . C0+CC3  Ev  CURP£NTr  5.G0-CG6  AHPS  CUT-OFF  ANGLE:  JG.GCQO 

shaoowxns  being  calculated  fop  gun  i 

4 DISTANCE  EQUALS  22*627617 
FINAL  NA1  : 2C 

shadowing  being  calculated  fop  gun  : 

01 STANCE  equals  22.627617 


FINAL  NA 1 : 20 

ShA 0 0 • I N 6 BEING  CALCULATED  FOP  GUN  3 
0ISTANCE  EQUALS  22.627617 

FINAL  NA 1 : 2C 

SHADOWING  BEING  CALCULATED  FOR  GUN  <* 

distance  Equals  22.627*17 
final  NA 1 : 2C 


Figure  10.12.  TANK  sample  output. 
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10.14  TRILIN 


Sample  output  from  TRILIN  is  shown  in  Figure  10.13.  The 
references  are  as  follows: 

1.  The  flux  definition  input  is  summarized. 

2.  The  present  state  of  the  charging  calculation  is 
summarized. 

3.  A flux  breakdown  is  printed  for  the  cells  requested. 

4.  The  net  current  to  the  whole  object  at  the  beginning 

of  the  timestep  is  printed,  with  and  without  the  effect 
of  electric  field  suppression  of  low  energy  emission. 

5.  The  capacitance  of  the  object  to  infinity  is  stated. 

6.  The  average  flux,  over  the  timestep,  to  the  cells  chosen 
for  a flux  breakdown  is  printed. 

7.  A summary  of  charging  activity  and  new  conductor 
potentials  for  the  cycle  is  printed. 

8.  A summary  of  final  surface  cell  potentials  for  the 
present  cycle  is  printed. 
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Figure  10.13.  TRILIN  output. 
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11.  A WORKED  EXAMPLE 


11.1  INTRODUCTION 

In  this  chapter  we  work  through  a real  NASCAP  example.  We 
describe  the  NASCAP  runs  that  were  made  and  how  we  decided  on  the 
options  and  other  parameters  that  were  used.  In  this  way,  we 
Illustrate  the  use  of  NASCAP  at  a practical  hands-on  level. 

No  one  example  could  use  all  of  the  features  of  the  code. 
(This  would  almost  certainly  be  confirmed  by  anyone  who  has  just  read 
the  previous  ten  chapters!)  Examples  showing  the  use  of  important 
options  that  are  not  part  of  this  worked  example  are  included  in  the 
relevant  earlier  chapters. 

In  the  example  we  have  chosen  to  work  through,  we  assume  that 
we  are  supplied  with  a design  for  a proposed  satellite,  and  a 
description  of  the  type  of  plasma  environment  it  might  be  expected  to 
encounter  in  orbit.  This  gives  us  a good  starting  point  for  the 
preparation  of  two  of  the  three  major  user  input  files:  The  object 
definition  file  and  the  flux  definition  file.  The  makeup  of  the  third 
input  file,  (the  run  options  file),  depends  on  the  type  of  simulation 
that  we  want  to  carry  out. 

Let  us  assume  that  the  satellite  is  to  have  a particle 
detector  mounted  on  its  surface.  If  the  satellite  charges 
differentially  (i.e.,  the  different  dielectric  materials  acquire 
different  surface  potentials)  the  spectrum  of  particles  collected  by 
the  detector  might  be  affected.  We  want  to  use  NASCAP  to  analyse 

(a)  the  charging  of  the  satellite,  exposed  to  the  chosen 
plasma  spectrum,  to  equilibrium. 

(b)  how  the  satellite  being  charged  in  this  way  affects  the 
operation  of  the  detector. 


We  begin  this  study  by  establishing  the  object,  its 
capacitance,  and  shadowing.  In  a series  of  runs  we  determine  the 
charging  response  of  the  object  with  the  supplied  plasma  spectrum. 
Finally,  we  examine  the  operation  of  the  detector  using  the  DETECT 
modul e . 

11.2  OBJECT  DEFINITION 

The  first  step  in  our  study  is  to  define  the  object  at  hand. 
The  satellite  in  our  example  consists  of  a central  cuboid  and  two 
spherical  globes,  each  at  the  end  of  a metallic  boom.  One  of  the 
globes  is  electrically  isolated  from  the  rest  and  forms  a separate 
conductor.  All  but  one  face  of  the  satellite  body  is  covered  with 
KAPTON.  The  remaining  face  is  covered  with  GOLD  foil.  The  booms  are 
made  of  ALUMINUM.  One  of  the  globes  is  covered  with  KAPTON.  The 
second,  electrically  isolated  globe,  is  covered  with  SOLAR  cell  cover 
glass  material  - called  "SOLAR".  This  is  Si02  glass  covered  with  a 
MgF2  non- reflective  layer. 

The  object  definition  file  defining  a NASCAP  representation 
of  this  satellite  is  shown  in  Figure  11.1.  The  materials  GOLD  and 
SOLAR  have  their  properties  definited  explicitly.  The  remaining  two 
materials  specified,  KAPTON  and  ALUMINUM  are  default  materials,  and 
their  properties  are  read  in  from  the  default  materials  table.  The 
object  consists  of  five  building  blocks:  The  central  RECTAN,  two 

BOOMS,  and  two  QSPHERES.  The  second  QSPHERE  forms  CONDUCTOR  2. 
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S0:HATERIAI  SOLAR 

5UEND0BJ 

S2IENDSAT 


The  choice  of  coordinates  for  each  building  block  is 
determined  by  the  physical  size  of  the  object  and  the  choice  of  XMESH. 
Let  us  assume  that  our  object  has  the  following  dimensions: 


Part 

Globe  diameter 
Boom  length 
Cuboid 
Boom  radius 

A choice  of  XMESH  = 0.020  m (20  mm 
replaced  by  mesh  units  as  follows: 

Part 

Globe  diameter 
Boom  length 
Cuboid 
Boom  radius 


Size 

63  mm 
41.5  mm 

78  x 78  x 124  irm 
1 mm 

allows  these  dimensions  to  be 

Size  (mesh  units) 

3 = (60  mm) 

2 = (40  mm) 

4x4x6(=  80  x 80  x 120  mm) 
0.05  ( = 1 mn) 


It  is  always  almost  impossible  to  reproduce  the  dimensions  of  the 
object  exactly.  XMESH  usually  turns  out  to  be  a compromise  choice, 
giving  the  best  overall  representation  of  the  object.  We  could  have 
chosen  XMESH  to  be  smaller  and  still  have  been  able  to  fit  the  object 
within  the  17  x 17  x 33  inner  mesh.  However,  since  the  object  is 
fairly  simple  a detailed  representation  results  in  little  gain  in 
accuracy  compared  with  the  extra  computational  effort  involved. 
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11.3 


THE  FLUX  DEFINITION  FILE 


Let's  suppose  we  are  lucky  and  the  plasma  environment  we  have 
been  given  is  in  Maxwellian  form,  with  the  following  parameters. 

Electrons  Ions 

fi  c _o 

Density  1.2  x 10  m 0.8  x 10  m 

Temperature  5.0  keV  3.0  keV 

This  data  can  be  entered  directly  into  the  flux  definition 
file  as  shown  in  Figure  11.2. 

If  the  environment  description  was  in  some  other  form  it 
might  first  be  necessary  to  reduce  it  to  either  a single  Maxwellian  or 
double  Maxwellian  form  by  a least  squares  fit.  Tables  of  data  can  be 
entered  directly  (5.4.3),  but  this  is  not  recommended. 

The  angular  distribution  of  the  plasma  is  isotropic. 


It  SINGLE  IMXUELLIMi 
2>S.O  KEV 
3U.2  CCS 
4t3. e KEV 
Ste.BEM  NTS 
6»£ND 

EOF!  6 

• t> 


Figure  11.2.  FLUX  definition  file. 
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11.4 


THE  OPTIONS  FILE 


The  options  file  for  the  first  run  is  shown  in  Figure  11.3. 
XMESH  has  been  set  to  20  ram,  as  decided  during  the  object  definition. 
The  purpose  of  our  first  NASCAP  run  is  to  establish  the  object  and 
make  one  trial  call  to  TRILIN.  Hence,  just  one  short  (5  second)  cycle 
is  requested  using  DELTA  and  NCYC.  As  we  shall  see  later  in  Section 
11.6,  the  results  of  this  trial  cycle  will  give  us  insight  into  the 
parameters  we  shall  choose  for  the  subsequent,  charging  runs. 

When  orbiting  the  earth  the  satellite  will  find  itself 
exposed  to  sunlight.  We  assume  that  the  sun  lies  in  the  XY  plane  of 
the  satellite  and  shines  with  a normal  intensity.  These  assumptions 
are  introduced  into  the  run  using  the  SUNDIR  and  SUNINT  cards  as  shown. 

The  LONGTIMESTEP  option  is  specifically  requested.  This  is 
always  a good  idea,  unless  a detailed  simulation  of  the  transient 
charging  response  is  required  (see  Section  6.2.6).  Any  plots  produced 
are  set  to  be  routed  to  the  S-Cubed  electrostatic  plotter. 

Finally,  a detailed  flux  breakdown  is  requested  for  the  seven 
surface  cells  shown  using  the  SURFACE  CELL  option.  These  cells  are 
not  chosen  at  random,  but  on  the  basis  of  a preliminary  interactive 
run. 


ltXJlESH  I.N 
2»NCVC  i 
3* DELTA  S 
4t SURFACE  CELL  2* 

5 t SURFACE  CELL  129 
S> SURFACE  CELL  29 
7* SURFACE  CELL  77 
8 i SURFACE  CELL  88 
9 1 SURFACE  CELL  167 
1® i SURFACE  CELL  181 
UtLOHGTinESTEP 
12tSUNINT  1.8 
13>SUNDIR  1 1 8 
14 « BEST  ELEC 
15 < END 
EOF t IS 
9t> 


Figure  11.3.  The  OPTION  file  (first  run). 
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11.5 


A PRELIMINARY  LOOK  AT  THE  OBJECT 


Before  submitting  the  first  batch  run,  it  is  a good  practice 
to  check  to  see  if  your  object  definition  file  actually  defines  the 
object  you  had  in  mind.  This  can  be  done  quickly  and  easily  by 
running  NASCAP  interactively  from  a graphics  terminal.  The  input 
files  are  prepared  as  described  in  Sections  11.2  - 11.4.  NASCAP  is 
executed  like  any  other  interactive  program  and  the  primary  keywords 
RDOPT,  OBJDEF  and  SATPLT  are  entered  at  the  keyboard  as  prompted. 

Since  output  is  routed  to  the  terminal  immediate  feedback  is  available 
and  mistakes  can  be  readily  corrected.  Plots  can  be  routed  to  the 
terminal  or  plotter  using  the  DEST  option  (Section  6.6.3). 

The  same  effect  can  be  achieved  more  easily  using  the  NASCAP 
auxiliary  code  NASCAP*OBJCHECK.^^  This  is  a fully  interactive 
combination  of  OBJDEF  and  SATPLT,  specifically  designed  to  check  out 
the  definition  of  objects  at  a graphics  terminal. 

As  a byproduct  of  an  interactive  look  at  the  object  a surface 
cell  list  is  displayed.  This  allows  us  to  pick  out  the  cell  numbers 
to  be  included  on  SURFACE  CELL  cards  in  the  options  file.  In  our 
example,  cells  on  the  cuboid  pointing  in  the  +x  and  +y  directions  were 
chosen,  along  with  cells  pointing  in  the  +z  directions  on  the  globes, 
and  a boom  cell.  This  selection  gives  an  all-around  look  at  the 
spacecraft  and  samples  all  building  blocks  and  all  materials.  The 
flux  breakdowns  from  these  cells  will  be  very  useful  in  understanding 
the  physics  behind  the  charging  of  the  satellite  during  the  simulation. 


11.6 


THE  FIRST  RUN 


A UNIVAC  version  of  the  NASCAP  runstream  used  for  the  first 
run  is  shown  in  Figure  11.4.  The  sequence  of  cards  can  be  classified 
into  6 groups,  labeled  A-F. 

A.  Simple  utility  cards  initiate  the  run  and  create  a 
heading. 

B.  Temporary  work  files  are  assigned. 

C.  The  prefixed,  permanent  files  are  copied  into  their 
temporary  counterparts.  (This  protects  any  permanent 
information. ) 

D.  The  NASCAP  absolute  is  executed. 

E.  The  NASCAP  primary  keywords  are  read  by  the  main  program. 

F.  If  NASCAP  has  executed  successfully,  the  permanent  files 
are  updated.  If  execution  is  aborted  these  steps  are 
never  reached. 

All  NASCAP  runstreams  follow  this  pattern.  Only  the  sequence  of 
primary  keywords  changes. 

In  this  first  run  RDOPT  is  the  first  module  to  be  executed. 
This  is  true  of  every  run.  The  next  four  modules  OBJDEF,  SATPLT, 

CAPACI  AND  HIDCEL  establish  the  object:  OBJDEF  formally  defines  it, 

SATPLT  produces  3D-VIEWS  (6.6.1)  and  MATVIEWS  (6.6.4),  CAPACI 
determines  its  capacitances,  and  HIDCEL  its  shadowing  table.  Finally 
a call  to  TRILIN  is  made  for  a trial  charging  cycle. 

The  printed  output  produced  by  this  run  is  shown  in  Figure 
11.5.  The  graphical  output  is  shown  in  Figure  11.6. 
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Figure  11.4.  NASCAP  runstream  (first  run). 
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Figure  11.5.  First  run  printed  output. 
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Figure  11.5.  (Continued) 
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gure  11 .5,  (Continue 


-QOOOQO-tOOHOOO^O^OOO-OHaOaOOOHaDNOQOHO^^oaOHO^a 

• III  I I I I I 

O^O^O-OOhOOOOOGOOOOOOOO-O-CHODhDO^^O^oOCOOh^OnO- 

* 1 1 • I I I I I 

0070T07qo70T770T07T707007070"<OQ7OOQQOQOOOOOOoQOOOP 


»®«®«CB9*0*^e>>^OOOaOOOOOOf^‘NNNf*®00>^OOODOONN 


a 

2 

o 


ooaooQoooooooooooocoaoaooQCQoooooooaoooGoooaoGOoQc 

5^  5*22,OMOOO-OW  O OQ^O«  ff  0»  OB’  O^-JT 

gr^f^P^Q^^^P^o^^^o^og^P^o^OQ^o^^o^oooopoQQOQ^ 

MO  OO  OOOOOOOOMMwptPixwxwMw^wxwfw^^wp^ooOOOOwwtPW  w*<*<xw<Qa 

-j  22S2202ooooaoooooOOOOODOOOGOOOOOOaooo°ooooooooaooo 

JjJ  OOOOOOOOOOOOOOOOOOQOOOaaOOOQDOOOOaOOQOGOOOOOQCOODO 

o 

• 

wo 

uz 

” »^-*p*^NNNNNMNNN(Mwn««wnn««na‘*#»a'»a-tf^»tft 


396 


Figure  11.5.  (Continued). 
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Figure  11.5.  (Continued). 
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Figure  11.5.  (Continued). 
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Figure  11.5.  (Continued). 
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Figure  11.6(a).  3D-VIEW  of  object  produced  by  SATPLT  (Hidden  lines). 


Figure  11.6(b).  3D-VIEW  of  object  produced  by  SATPLT  (No  hidden  lines). 
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Figure  11.6(c).  3D-VIEW  of  object  produced  by  SATPLT  (Hidden  lines). 
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Figure  11.6(d).  3D-VIEW  of  object  produced  by  SATPLT  (No  hidden  lines). 
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Figure  11.6(e).  3D-VIEW  of  object  produced  by  SATPLT  (Hidden  lines). 
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Figure  11.6(f).  3D-VIEW  of  object  produced  by  SATPLT  (No  hidden  lines). 


SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEHED  FROM  THE  NEGATIVE  Z DIRECTION 
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Figure  11.6(g).  MATVIEW  produced  by  SATPLT  . 


SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWED  FROM  THE  NEGATIVE  Y DIRECTION 
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Figure  11.6(1).  MATVIEW  produced  by  SATPLT 


SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWED  FROM  THE  POSITIVE  T OIRECTION 
FOR  T VALUES  BETWEEN  I AND  17 
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Figure  11.6(j).  MATVIEW  produced  by  SATPLT. 


SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWED  FROM  THE  NEGATIVE  X 01 RECTI ON 
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Figure  11.6(k).  MATVIEW  produced  by  SATPLT. 


SURFACE  CELL  MATERIAL  COMPOSITION  AS  VIEWED  FROM  THE  POSITIVE  X DIRECTION 


Figure  11.6(1).  MATVIEW  produced  by  SATPLT 
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Figure  11.6(m).  3D-VIEW  of  object  generated  by  HIDCEL. 


The  printed  output  for  each  module  follows  the  same  format 
described  in  Chapter  10.  The  plots  have  the  standard  forms  discussed 
in  Chapter  9. 

The  output  shows  that  all  modules  executed  successfully  and 
that  the  object  is  fully  established.  Providing  the  sun  direction  is 
not  changed,  any  further  runs  need  involve  only  RDOPT  and  TRILIN 
modules. 


Inspection  of  the  TRILIN  output  shows  that  only  the  KAPTON 
cells  in  shadow  began  to  charge  negatively.  The  remaining  cells  have 
positive  net  currents,  either  due  to  photoemission  or  high  secondary 
yields.  This  is  reflected  in  the  last  of  the  cell  potentials  printed 
at  the  very  end  of  the  TRILIN  output.  The  shaded  KAPTON  cells  all 
have  potentials  of  around  -10  Y.  The  remaining  cells  are  close  to 
neutral  or  slightly  positive. 

When  only  one  part  of  an  object  is  charging  negatively, 

differential  potentials  between  it  and  the  rest  of  the  object  soon 

build  up.  However  the  electric  fields  associated  with  this 

differential  charging  act  to  limit  its  magnitude  by  causing  the  rest 

of  the  object  to  begin  charging  too.  This  occurs  because  the  electric 

field  inhibits  the  escape  of  low  energy  photo  and  secondary  electrons, 

thereby  cutting  off  the  source  of  positive  current  to  the  non-charging 

cells.  Hence,  eventually  the  charging  cells  (in  this  case  shaded 

KAPTON)  drive  the  whole  object  to  a negative  potential.  This  type  of 

[21] 

charging  has  been  described  as  "bootstrap",  "potential 

T221  [231 

barrier",  and  "saddle  point".  Because  it  occurs  via 
differential  charging,  its  timescale  is  typically  long  (minutes  rather 
than  seconds). 

In  our  example  the  KAPTON  is  charging  at  about  2 volts  per 
second.  We  shall  want  to  increase  the  timestep  in  the  second  run  so 
that  the  potential  changes  by  about  500  V per  cycle. 


11.7 


THE  SECOND  RUN 


In  this  run  we  call  only  two  modules,  and  the  NASCAP  primary 

keyword  input  consists  of 
RDOPT 
TRILIN 
END 

He  begin  the  charging-to-equil ibrium  simulation  with  a run  involving  5 
cycles.  If  more  are  needed  we  can  always  RESTART  a subsequent  run  and 
add  further  cycles.  With  the  initial  charging  rate  of  2V  per  second, 
a timestep  of  200  s will  increase  the  KAPTON  potential  by  -400  V each 
cycle.  This  is  a manageable  rate  of  charging.  We  continue  to  use  the 
LONGTIMESTEP  option,  this  time  with  a dvlim  of  500  V,  instead  of  the 
default  value  of  1000  V.  With  a higher  value  of  dvlim  there  is  a 
danger  of  potential  overshoot  and  oscillation. 

The  options  file  used  in  the  second  run  is  shown  in  Figure 
11.7.  Changes  have  been  made  to  NCYC,  DELTA  and  LONGTIMESTEP  as 
described  above.  The  mechanical  capacitance  between  the^two 
conductors  has  been  introduced  with  option  CIJ  (1  x 10  F). 

Contour  plots  for  the  last  cycle  have  been  requested.  The 
run  is  RESTARTed  from  cycle  1. 

The  output  from  the  second  run  is  shown  in  Figure  11.8. 
Inspection  of  the  flux  breakdown  shows  that  each  cell  gradually 
achieves  a negative  net  current  as  the  low  energy  emission  is 
suppressed.  Consequently  more  of  the  cell  potentials  become  negative 
from  cycle  to  cycle,  until  the  last  cycle  (number  6)  when  the  whole 
object  has  reached  almost  -1  kV  (as  measured  by  the  conductor 
potentials). 
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ItMKSH  I.M 
2 INC VC  I 
3 'DELTA  886 
4 1 SURFACE  CCU  M 
St  SURFACE  CCU  189 
StSURFACE  CCU  89 
?! SURFACE  CELL  7? 

9!  SURFACE  CEU  99 
9 1 SURFACE  CEU  16? 

1 9 ! SURFACE  CEU  181 
1HL0NCTIRESTEP  16M 
18tSUNINT  1.9 
13ISUNDIR  1 1 » 

MtOCST  ELEC 
lSlCXJ  1 8 l.E-18 
16 t CONTOURS  STANDARD  NOD  S 
1?« RESTART 
18 t END 
EOFt 18 
• i> 


Figure  H .7. 


The  Run  Options  file  (second  run 
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Figure  11.8.  Printed  output  (second  run). 


NASA  CHANGING  ANALYZER  PROGRAM 
OPTION  SUMMARY 
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ELECTRON  TEMPERATURE  = 5.00*003  ELECTRON  VOLTS 
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AVERAGE  NET  CHARGING  CURRENT  = -8. 609-012  AMPERES 

-A. 862+001  C00E  UNITS/SEC 
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Figure  11.8.  (Continued). 
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Figure  11.8.  (Continued). 
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Figure  11.8.  (Continued). 
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Figure  11.8.  (Concluded). 


By  the  end  of  the  run  we  note  that  neither  the  change  in 
conductor  potential  per  timestep  (-250  V)  nor  the  average  net  charging 
current  (~10  A)  has  changed  substantially.  Therefore,  we  decide 
to  perform  a third  run  to  continue  the  simulation  with  the  same 
parameters  for  an  additional  5 cycles. 

A potential  contour  plot  for  cycle  6 is  shown  in  Figure 
11.9.  Note  the  appearance  of  a saddle  point  at  the  right  of  the 
figure. 
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11.8 


THE  THIRD  RUN 


This  run  is  carried  out  with  the  same  parameters  as  the 
second  run,  extending  the  number  of  cycles  out  to  11.  The  printed 
output  and  contour  plots  for  cycle  11  are  shown  in  Figure  11.10.  The 
conductor  potential  has  reached  -2.1  kV  and  the  KAPTON  -4.1  kY.  the 
current  breakdown  for  KAPTON  shows  that  the  net  current  is  decreasing 
as  equilibrium  approaches.  In  the  next  run  we  increase  the  timestep 
and  dvlim,  to  hasten  the  attainment  of  equilibrium. 
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Figure  11.10a.  Trilin  Output  for  cycle  11 
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Figure  11.10a.  (Concluded) 
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Figure  11.10b.  Potential  contours  for  cycle  11. 
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11.9 


EQUILIBRIUM 


Two  more  runs  are  carried  out,  adding  a further  10  cycles. 
In  each  run  DELTA  is  increased  to  500s  and  dvlim  to  1000. 

DELTA  500s 
LONGTIMESTEP  1000 

The  printed  output  and  contour  plot  for  the  final  cycle  is  shown  in 
Figure  11.11  and  Figure  11.12. 

The  potentials  remains  steady  for  cycles  18-21,  showing  the 
equilibrium  has  been  achieved.  The  final  equilibrium  potentials  are 
as  follows: 


Type  of  cell 


Potential  (kv) 


Shaded  KAPT0N 
Sunlit  KAPT0N 
GOLD 

SOLAR  sphere 


- 5.1 
^ -3 
^ -3 


From  these  results  we  draw  the  following  conclusions: 

1.  The  spacecraft  will  charge  considerably  in  the  given 
environment,  but  only  on  a differential  charging  (long) 
timescale.  Charging  is  driven  by  the  shaded  KAPTON, 
whose  electric  field  suppresses  emission  from  the  other, 
initially  non-charging,  surfaces. 

2.  Differential  potentials  in  the  2 + 3 kV  range  are  likely. 


460 


IO 

* 

o 

H> 

o 

o 

♦ 

o 

i 

1 © 

0» 

i 

1 

• 

i 

1 CM-* 

i 

1 H 

1 

i 

m 

i -*oo 

i 

• z 

i © 

II 

i 

in  o 

1 9 H- 

X 

i 

O MM 

1 0«hQ. 

© 

i 

Z H- 

1 O 1 < 

m 

i 

o < 

1 X 

o 

i 

o a 

1 

i 

y u * 

1 

mm 

i 

m o.m 

1 II  II 

• 

•m 

i 

oz 

♦ 

a 

m 

so 

» 

HI  o 

I Z II  u 

u 

c 

o 

i 

o act 

1 o < 

►* 

z 

CM* 

i 

O UH 

i m-i.jM* 

u 

© 

o® 

i 

♦ mo 

i u<a 

X 

u 

OO* 

i 

in  ulj 

i y«y 

■N. 

Ui 

♦ • 

i 

a «~»-i 

i ooam 

m 

m 

QH 

i 

m xu 

i ooo< 

m- 

C 1 

i 

• uj 

1 UJZZ 

KJ  * _ 

i 

«z  o 

i 

UjO  M»  h»K  «>f-  o 1 O 

Q 

i 

u «U 

i 

u>o  OOOCOO  1 o 

o 

o 

i 

3mm 

i 

mu  o ooooao  i o 

♦ 

i 

1 1 V)u*~ 

• 

KITO  1 1 1 1 I 1 II 

i 

©MM 

i 

j\o  ♦ oh^hmno  i m 

o 

20 

t 

u*-ctx 

i 

o mao  (Mi/uffCDHO  i c 

tn 

»»U 

i 

xz<y 

i 

• 

t 

H3X 

i 

J0>0  1 © 

2U 

i 

u>OU> 

i 

K>OH  • 1 

UiUi  w# 

i 

omo 

i 

□ >AH  1 

use  oo 

i 

una 

i 

o • 

a oo 

• 

<OU 

i 

♦ mm 

ii 

©o  ♦ ♦ 

i 

z 

i 

mo  i 

zu  (Min 

i 

o *w 

i 

mQ  ll 

Ui 

H 

i 

hh>  1 

i 

mm  ♦ II 

X 

Z 

i 

MZUI 

i 

•O'  a 

MM 

•u  * • 

i 

MHO 

i 

tftHOO 

m 

l/>Ui  (MKI 

i 

»u 

i 

1 NJK 

U(K  1 1 

i 

UiUJH 

i 

•UIU 

HU 

i 

uxma 

i 

Zt4 

i 

U<UO 

t 

lulu 

3—  mm«o 

i 

i 

■i 

IAOOQ 

i 

o a 

i 

< II  uo 

UIZOOOQ 

i 

uzm 

i 

m <z  ma  m 

QOQI ♦ ♦ 

t 

a -jo  a 

i 

hi/jzh  yy  u 

Om  IIAOh 

i 

OMUO 

i 

Zmam  mmm-  mm 

UK^an^ 

i 

U3  *- 

i 

uuuh  zh  a 

o<Mno*(M 

i 

UiU 

i 

mamx  x 

Ului  •O'  • • 

i 

«1CLU< 

i 

OHXh  ou  o 

CM 

OftH  *Nm 

i 

y«u 

i 

ainuiu  ztn  z 

Ott  1 -m  1 

i 

xuu 

t 

ox  o 

♦ O 1 

i 

3«na© 

» 

mou  u 

<OU  M II  II 

i 

J43Z 

i 

zy<  u>* 

• 

O uill 

i 

UZiAM 

i 

omcommm 

o 

»OJ  oo 

i 

m- 

i 

a z *-* 

z 

*«2<ZZZ 

i 

o 

I o 

hOOOO> 

1 hUOOO 

i 

yo.<s 

1 N 

ozzhzh 

Ui 

zmmoo 

i 

^Ul  m 

1 

UJMMMM  ©MMM-m 

_J 

II  UiOOCU© 

i 

<UV)J 

1 

JMMZMUZ 

u 

X Ui 

i 

1 

NyjjaJSu 

> 

OK 

i 

3wuu 

I • 

* 33  30CC 

u 

l/)U 

i 

UZUO 

t o 

«unmunza 

Qryi 

i 

JHW 

1 z 

szyyzyo 3 

z 

i 

•o»wz 

1 

syzzyauu  x 

MM 

Ott 

i 

u uo 

1 -* 

<Q  O 0 3 

o 

ZUi 

i 

«n  m 

1 u 

UI  Hi  XI*  U 

Ui 

DU 

i 

1 u 

Zu  U -JO  lu 

m 

ou. 

i 

JZ« 

1 u 

HZ  Z 3X 

Iu< 

i 

1 

HI  MM  030.  M- 

t 

*m  oa 

1 Ui 

m u 

CC 

i 

OOm< 

1 o 

u z 

Ui 

• 

NZh> 

1 < 

X 

X 

i 

_J| 

1 iu 

3 

3 

i 

Q.0COO 

i a 

u 

m 

i 

K30Z 

1 3 

lu 

O 

i 

WO«< 

i m 

m 

m 

o 

3 

w 

9 

a 

t H 

MMfHO 

1 Mf*0 

CM-M 

1 CM— 

CM 

1 m 

HOH 

n mm 

i om-mm 

Ohm 

f-  mm 

|^l 

9 M» 

o a a 

1 m h 

0©OCL 

o o o 

1 00*00. 

o < 

1 1 1 

i a x 

X 

to  H H4 

I X 

CM  CM  ® 

i 

• • • 

| 

II  II 

m -h  -m 

i ii  ii 

a 

i 

a 

ztiu  ui 

t Zll  -i 

u 

O < H 

u u u 

1 o •* 

m 

11  HJH  U 

1 IImMJmm 

O 

u«ft  X 

1 m<a 

X 

y<zy  Xi 

1 u<Xu 

>k 

out  h m 

1 oo  am 

m 

ooo<  u 

1 ooo< 

M- 

UJZZ  ftj 

1 

1 UJZX 

au 

uiO 

©®m«  coo®  1 m 

i 

uo 

MM* 

M-»CM 

OOCOOhO I o 

i 

M>0 

COC 

mu  o 

OOOOOOO 1 o 

i 

mu  o 

□oo 

HZNO 

1 1 1 1 1 1 1 1 1 

• 

mx®0 

1 1 1 

J\Q  1 

nMAlAAnA  • M* 

i 

JSO  ♦ 

0-4® 

©mo® 

NONJ'hhW  1 MO 

i 

omoD 

IMin-4 

»H-  U A* 

i 

sum*  ♦ a 

jrm 

•Minmi)«u*H  i m 

i 

JAO 

a 

3 

2 

mo®  • 

i 

i 

mo  mm  • 

O»mo* 

i 

i 

0»iT»mm 

o • 

i 

3 • 

♦ lON 

i 

♦ MS’ 

hO 

t 

mo  i 

r-a  ll 

t 

hC  II 

o ♦ II 

i 

•M  ♦ 11 

• 9 a 

t 

• c a 

m-noo 

i 

tflHOO 

1 HJU 

i 

1 MJM 

•uu 

i 

•UiO 

• 

ll  HM<« 

lulu 

t 

kk 

i 

<11  UO 

i 

<11  JO 

MM  <Z 

ma  m 

i 

►M  «Z 

ma 

UvOZmm 

uu  u 

i 

mAZh 

uu 

ZtrttH 

NH  MM 

i 

zmcem 

HM 

IJUIJi-1 

am  a 

i 

UUUH 

s •* 

uauz 

«<  < 

i 

HfltMZ 

4C  MC 

OhXh 

oo  o 

i 

Oh<h 

OO 

a.muu 

Zm  Z 

i 

a.muJ 

zm 

ox  o 

i 

o X 

moo  u 

i 

moo 

zu<  um 

i 

zu< 

omommm 

i 

oma 

a z « 

i 

a 

cc 

h|9CO<9> 

1 M- 

HOC 

CM 

UZZHZH 

1 M 

ozz 

UHMONMM 

1 

UHh 

JHMtHOZ 

1 

^ 

NUJjO.J3y 

1 

NUUJ 

• 

• 33  sot 

I • 

W -U  * 

o 

•uinmu«nzt 

1 o 

• mmrn 

z 

XZUUZU03 

1 z 

XZUU 

vyttytuu  x 

1 

suto; 

u 

<0  o 0 3 

1 J 

_l 

mm  *h  arm  u 

1 u 

MM 

Ui 

Zu  U JO  U. 

1 u 

zo 

u 

HZ  Z 3 X 

1 o 

mmZ 

mm  mm  aa  a.  m 

1 

MM 

Ui 

m u 

1 u 

m 

o 

u Z 

1 u 

u 

< 

X 

1 « 

X 

lu 

3 

1 u 

3 

a 

u 

* a 

U 

3 

lu 

1 3 

lu 

m 

i m 

i 

461 


Figure  11.11.  Tr  11 1 n output  for  cycle  21 
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l.*S?  CYCLE  COMPLETED  IS  21 


11.10  THE  DETECTOR 


The  question  that  remains  to  be  answered  is,  how  does  this 
charging  affect  the  operation  of  an  on-board  particle  detector  ? 
Suppose  an  ion  detector  is  mounted  on  the  shaded  side  of  the  SOLAR 
sphere,  looking  towards  the  KAPTON  sphere.  Will  the  electric  field  of 
the  negatively  charged  KAPTON  deflect  incoming  ions,  and  affect  the 
sampling  of  the  detector?  We  can  simulate  the  operation  of  a detector 
with  a new  run  using  the  DETECT  module. 

11.11  THE  DETECT  RUN 

We  choose  the  spare  file  number  23  for  the  detector  input 
file.  This  is  shown  in  Figure  11.13. 

Cell  170  is  chosen  as  the  site  for  the  detector,  which  looks 
out  in  the  positive  y direction.  $ is  set  to  zero.  The  energy  range 
chosen  is  1 - 10,000  eV  and  the  angle  theta  is  scanned  over  the  ZY 
plane  from  -88*  to  + 88°.  The  cone  collecting  particles  is  defined  to 
have  a half-angle  of  1*.  If  theta  were  scanned  from  -90°  to  90°  some 
of  the  particles  would  have  been  emitted  towards  the  object  {with  an 
angle  91*!)  This  causes  an  execution  error. 

The  energy  range  is  sampled  with  12  particles.  The  cone  is 
so  narrow  that  only  one  angle  sample  is  used  (the  default). 


1*DETECT 
2*ICELL  170 
3 « ENERGY  t 
4>D£K  1NMN 
5 t THETA  -88 
6SDTH  1 
7lPHI  8 
8JNE  12 
9: AUTOS 

lOi IHDUAR'THETA 
lltFINPLU  88 
12«N  40 
131PIPART 
14INGBND  1 
lSaiMGRD  2 
16! END 
EOF i 16 
0i> 

Figure  11.13.  DETECT  input  file  (MANUAL23) . 
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The  NASCAP  runstream  executing  the  run  is  shown  in  Figure 
11.14.  The  energy  flux  density  plot  is  chosen  to  be  plotted  against 
theta.  The  plot  is  shown  in  Figure  11.15.  A dropout  in  proton  flux 
occurs  at  angles  of  less  than  about  -70°.  Inspection  of  the  YZ  plane 
particle  trajectories  (Figure  11.16)  show  that  this  is  due  to  the 
charged  KAPTON  sphere  capturing  the  protons  coming  from  this 
direction.  The  flux  dropout  corresponds  to  particles  originating  on 
the  KAPTON  sphere  (which  do  not,  in  reality,  originate  at  all). 

The  electron  flux  is  apparently  unaffected.  The  trajectory 
plots  show  however  that  particles  that  are  apparently  arriving  at 
grazing  angles  < -70°,  originally  approached  at  much  more  normal 
angles.  The  detector  therefore  sees  a distorted  angular  distribution. 
To  be  sure  of  this  interpretation,  we  must  compare  results  with  these 
for  an  uncharged  spacecraft. 
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Figure  11.14.  DETECT  r.unstream. 
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11.12  A DETECTOR  ON  AN  UNCHARGED  SPACECRAFT 


We  can  zero  the  potential  on  the  object  using  the  IPS 
module.  If  no  parameter  cards  are  included  as  input  this  module  sets 
all  potentials  in  accordance  with  the  run  options. 

The  results  are  shown  in  Figures  11.17  and  11.18.  The 
trajectory  plots  show  no  deflection,  and  there  is  no  proton  flux 
dropout.  The  actual  magnitudes  of  the  electron  and  proton  energy 
fluxes  are  smaller  and  greater  respectively  for  the  charged  object 
compared  with  the  neutral  object.  This  is  a reflection  of  their 
deceleration  and  acceleration  respectively  by  the  satellite  electric 
field. 
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11.13  SUMMARY 


As  a result  of  these  simulations  we  have  learned  the 
following: 

1.  In  the  environment  given  the  object  charges  negatively 
with  differential  potentials  of  up  to  3 kV. 

2.  The  differential  potentials  affect  the  operation  of  a 
particle  detector.  In  particular,  a detector  looking  at 
a more  negative  piece  of  the  spacecraft  will 
underestimate  the  ambient  proton  energy  flux  and  see  a 
distorted  angular  distribution  for  the  electron  flux. 
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APPENDIX  A 


SUBROUTINE  PRECIS 
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SUBROUTINE  ADBOOM 

Generates  polygons  for  boom  cells  to  be  used  for 
shadowing  and  hidden  line  satellite  plots.  Represents 
booms  as  square  cross  sectioned  rods  for  graphical 
purposes  only. 

SUBROUTINE  ADDA1 

Adds  a subdived  surface  cell  polygon  to  the  list  of 
surface  polygons.  The  polygons  can  be  subdivided  as 
part  of  the  shadowing  calculations. 

SUBROUTINE  ADDCND 

Adds  one  matrix  element  between  conductor  nodes.  This 
is  done  during  the  ICCG  matrix  setup. 

SUBROUTINE  ADDME 

Adds  a matrix  element  to  the  sparse  matrix  being  set 
up  for  ICCG. 

SUBROUTINE  ADDVXB 

Adds  vector  cross  product  to  another  vector.  Used  to 
push  particles  in  a magnetic  field. 

SUBROUTINE  ADEMIT 

Adds  emitter  fluxes  to  the  net  currents  of  individual 
surface  cells.  Also  accounts  for  the  charge  which 
returned  to  the  satellite. 

SUBROUTINE  ADF 

Advances  to  the  next  plot  frame. 

SUBROUTINE  ADJRE 

Adjusts  plot  co-ordinates  for  plots  of  quantities  over 
more  than  one  grid.  Used  for  potential  contour  plots. 

SUBROUTINE  ADJUST 

Calculates  total  emitted  beam  current  to  adjust  return 
emitter  currents. 

SUBROUTINE  ANGAVG 

Averages  shadowing  of  surface  cells  over  several 
angles  of  rotation.  Used  for  the  SPIN  option. 

SUBROUTINE  ANTERP 

Performs  linear  interpolation  to  determine  anisotropy 
for  given  energy  and  species. 

SUBROUTINE  APRNTV 

Prints  character  string  labels  on  plots.  Labels  can  be 
horizontal  or  vertical. 
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SUBROUTINE  APRT 

Utility  routine  to  print  out  information  in  a file. 

RDOFT  keyword  APRT  governs  usage. 

FUNCTION  AREA 

Calculates  surface  area  of  a polygon.  Used  during 
shadowing  calculations. 

SUBROUTINE  ASGFIL 

Assigns  mass  storage  files  to  be  used  during  a NASCAP  run. 
SUBROUTINE  ASUNDR 

Converts  10  character  CDC  words  to  4 character  words. 
Complements  TOGETH. 

SUBROUTINE  AXISXV 

Plot  routine  to  draw  line  parallel  to  the  X— axis. 
SUBROUTINE  AXISYV 

Plot  routine  to  draw  line  parallel  to  the  Y— axis. 
SUBROUTINE  A1C0MP 

Compresses  the  surface  cell  polygon  list  to  remove 
those  which  are  completely  obscured  from  view. 

SUBROUTINE  A1GEN 

Generates  the  3— D co-ordinates  of  the  surface  cells 
for  a given  perspective.  Used  for  shadowing  and 
satellite  plotting. 

SUBROUTINE  A2GEN 

Generates  3— D and  2— D vertices  of  object  building 
blocks  for  use  in  shadowing  and  satellite  plotting 
routines. 

SUBROUTINE  A2PL0T 

Non— hidden  line  plots  of  the  building  block  faces. 

These  are  diagnostic  plots  used  during  object 
definition. 

SUBROUTINE  BADCEL 

Find  cells  where  electric  fields  limit  low  energy 
electrons.  Part  of  LONGTIMESTEP  algorithm. 

SUBROUTINE  BADCOND 

Determines  which  conductors  have  electric  fields  which 
prevent  their  low  energy  photo  and  secondary  electrons 
from  escaping. 
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SUBROUTINE  BADEMT 

Sets  trial  potentials  tor  conductors  having  ion  or 
electron  emitters.  Magnitude  ot  charge  is  determined 
taking  into  account  whether  the  environment  is 
charging  in  the  same  or  opposite  direction  as  the 
emitter. 

SUBROUTINE  BADTRI 

Estimates  the  potentials  ot  cells  whose  low  energy 
electron  emission  (e.g.  photo  emission)  is  electric 
tield  limited.  Assumes  the  potential  exterior  to  a 
cell  changes  halt  as  rapidly  as  the  cell  potential. 

SUBROUTINE  BAXSET 

Sets  maximum  plot  dimensions  tor  SILHOU  to  take  into 
account  the  booms. 

SUBROUTINE  BDQTRI 

Gets  trial  changes  in  the  charges,  DQ's,  tor  boom 
cells. 

SUBROUTINE  BFIELD 

Calculates  the  magnetic  tield  vector  tor  a given 
point  in  space  trom  input  constant  plus  dipolar 
tiel ds. 

SUBROUTINE  BIAFIX 

Modi ties  inhomogenous  term  ot  the  potential  equations 
to  take  into  account  biased  conductors. 

SUBROUTINE  BINWGT 

Calculates  interpolation  weights  tor  boom  mesh 
intertace. 

SUBROUTINE  BJOINT 

Find  conductor  or  conducting  surtace  cells  which 
contact  a boom  node.  Used  when  constructing  surtace 
conductivity  intormation. 

SUBROUTINE  BKSCAT 

Pertorms  integrals  over  the  incident  spectrum  to 
calculate  total  electron  backscatter  trom  a surtace 
cell.  Calls  BSCAT  tor  actual  backscatter  coetticients. 

SUBROUTINE  BLARGE 

Calculates  the  capacitance  between  the  outer 
dielectric  coating  and  the  underlying  conductor  tor 
boom  cells.  NASCAP  reters  to  these  as  large 
capacitances. 

SUBROUTINE  BLDCYC 

Builds  the  cycle  ot  surtace  cells  surrounding  a given 
surtace  node. 

BLOCK  DATA 

Contains  the  weights  tor  use  in  the  three  dimensional 
potential  solving  routines. 
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SUBROUTINE  BMAREA 

Calculates  the  -fractional  boom  area  Mhich  recieves 
solar  illumination. 

SUBROUTINE  BMLINE 

Determines  if  a boom  and  a line  segment  intersect. 
SUBROUTINE  BOOM 

Defines  boom  during  object  definition.  Reads  and 
checks  user  specifications  of  size,  material,  and 
location. 

FUNCTION  BOOM AT 

Looks  up  the  material  which  covers  a particular  boom 


SUBROUTINE  BOOMDQ 

Calculates  the  change  in  surface  charge  for  boom 

sur*aces  koth  with  and  without  the  emission  of  low 
energy  electrons. 

SUBROUTINE  BOOMEJ 

Finds  edges  separating  boom  surfaces  and  adds  them  to 
the  edge  list. 

SUBROUTINE  BOOMGT 

Retrieves  surface  cell  information  for  boom  cells. 
Information  returned  includes  material  coating,  area 
underlying  conductor,  potential,  and  small  and  large* 
capacitances.  y 

SUBROUTINE  BOOMLT 

Constructs  the  list  of  boom  surface  cells  during 
object  definition.  Also  constructs  the  relevant  matrix 
elements  necessary  for  solving  Poison's  equation. 

SUBROUTINE  BOOM I 

Forms  the  list  of  insulating  boom  points  for  addition 
to  the  list  of  all  insulating  points. 

SUBROUTINE  BOOPLT 

Draws  a boom  or  a stub  which  represents  the  boom 
depending  upon  whether  or  not  the  entire  boom  fits 
within  the  first  mesh.  This  routine  is  called  during 
from  the  material  potting  routine. 

SUBROUTINE  BOTCEL 

Determines  whether  or  not  a surface  is  on  the  bottom 
o a thin  plate  or  points  into  volume  element  that  has 
even  one  node  which  is  a bottom  point. 

SUBROUTINE  BOTMBC 

Sets  initial  potentials  for  bottom  points. 
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SUBROUTINE  BOTMDQ 

Scales  potentials  of  bottom  points  based  upon  net 
change  in  total  charge. 

SUBROUTINE  BOTSUB 

Substitutes  bottom  point  values  for  ordinary  nodal 
values  in  the  potential  array. 

SUBROUTINE  BRSSUB 

Substitutes  bottom  point  values  -for  regular  nodal 
values  in  the  charge  density  array. 

SUBROUTINE  BSC AT 

Calculates  back  scattering  coefficients.  Contains  the 
physical  models  and  uses  the  input  or  default 
parameters. 

SUBROUTINE  BSKET 

Makes  calls  to  the  plot  package  to  sketch  booms  on 
material  plots.  The  end  of  the  boom  is  closed  if  it 
fits  within  the  first  mesh.  Otherwise,  a jagged  end  is 
drawn. 

FUNCTION  BETWEEN 

Logical  function  which  is  true  if  the  first  argument 
lies  between  the  other  two. 

FUNCTION  BULKB 

Calculates  the  bulk  conductivity  between  a boom 
surface  cell  and  its  underlying  conductor. 

SUBROUTINE  BULKC  Calculates  the  bulk  conductivity  current  for  a 
given  surface  cell. 

SUBROUTINE  BULKS 

Finds  bulk  conductivity  between  surfaces  and  their 
underlying  conductors  during  object  definition. 

SUBROUTINE  CALFLX 

Calculates  charging  fluxes  to  surface  cells.  Calls 
routines  such  as  BKSCAT  to  perform  actual  physics. 

This  routine  loops  over  the  surface  cell  list  and 
stores  the  fluxes. 

SUBROUTINE  CAPACI 

A major  code  module  called  by  the  main  NASCAP  routine. 

This  routine  uses  the  large  three  dimensional 
potential  solver  to  form  the  capacitances  used  by  the 
internal  current  integration  algorithms.  Capacitances 
to  space  are  found  by  solving  Laplace’s  equation  with 
a single  unit  of  charge  on  the  satellite,  finding  the 
structure  potential  and  then  determing  how  the  charge 
was  distributed  among  the  surface  cells. 
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SUBROUTINE  CAPERR 

This  subroutines  zeroes  out  the  capacitances  for  non 
used  conductors  - purely  a bookkeeping  task. 

SUBROUTINE  CAPPOT 

Calls  the  matrix  inverter  (ICCG)  during  current 
integration  calculation. 

SUBROUTINE  CAPPT2 

Second  routine  to  call  matrix  inverter  during  the 
current  integer at ion  calculation. 

SUBROUTINE  CCPRD 

Matrix  multiplication  routine  for  ICCG. 

SUBROUTINE  CCSUM 

Includes  or  excludes  the  small  stray  capacitances 
between  conductors  for  use  in  the  current  integration 
calculations. 

SUBROUTINE  CELGET 

Calculates  and  writes  out  capacitances  to  infinity, 
capacitances  to  underlying  conductors  , total  cell 
areas,  and  the  areas  associated  with  each  note.  Called 
by  CAP AC I . 

SUBROUTINE  CELLGT 

Retrieves  information  about  the  geometry  and 
orientation  of  a given  surface  cell  during  the  GENMTL 
surface  connectivity  calculation. 

SUBROUTINE  CELL 10 

Fast  and  general  file  access  utility  which  transfers 
block  data  between  main  memory  and  mass  storage. 

SUBROUTINE  CELLST 

Bookkeeping  routine  which  expands  or  contracts 
information  between  the  array  of  all  surface  cells 
and  the  array  of  insulating  cells  only. 

SUBROUTINE  CFLICT 

Determines  appropriate  action  for  the  case  of  a 1 0 0 
surface  which  points  into  a partially  filled  volume 
element.  Called  during  OBJDEF. 

SUBROUTINE  CHARGE 

High  level  routine  called  by  TRILIN  which  caluclates 
explicit  particle  fluxes  and  predictsthe  charge 
accumulation  and  distribution. 

SUBROUTINE  CIRCLE 

Draw  a circle  around  the  center  of  a plot. 
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SUBROUTINE  CKEDGE 

Checks  that  two  points  form  an  edge  common  to  two 
adjacent  surface  cell.  Called  during  the  construction 
of  the  connectivity  matrix. 

SUBROUTINE  CLARGE 

Calculates  and  writes  out  the  capacitances  between  the 
surfaces  of  insulating  cells  and  their  underlying 
conductors  using  a one  dimensional  approximation. 

SUBROUTINE  CLASFY 

Used  by  the  free  format  input  routines  to  classify 
input  as  integer,  real  or  literal. 

SUBROUTINE  CLINE 

Plots  the  detector  flux  curves. 

SUBROUTINE  CMPRSS 

Compresses  the  surface  cell  list  by  removing  any 
surface  cells  which  are  internal  to  the  object  and 
thus  play  no  role  in  the  charging  process. 

SUBROUTINE  CNDCUR 

Calculates  the  incident  conductor  particle  currents  at 
the  beginning  of  a time  step. 

SUBROUTINE  CNDMAT 

Assembles  the  conductivity  matrix  as  a result  of  the 
connectivity  calculation. 

SUBROUTINE  CNDSET 

Sets  surface  cell  potentials  to  the  value  of  their 
underlying  conductors.  The  insulating  cells  will  be 
reset  by  a following  call  to  CELLST. 

LOGICAL  FUNCTION  CNDTST 

Test  whether  a cell  is  an  exposed  conductor  for 
initial  potential  specification. 

SUBROUTINE  CNDUCS 

Calculates  matrix  product  for  conductor  equations 
during  the  three  dimensional  conjugate  gradient 
potential  calculations. 

SUBROUTINE  CNTOUR 

Finds  appropriate  levels  and  call  contour  routines 
during  plotting. 

SUBROUTINE  CNVGRD 

Converts  coordinates  of  a point  from  one  grid  system 
to  another. 

SUBROUTINE  CNVPLT 

Plots  convergence  parameters  during  three  dimensional 
potential  caluculation. 
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FUNCTION  COF 

Utility  which  returns  the  value  of  a six  bit  word 
segment  . 

FUNCTION  COINV 

Determines  if  a vertex  is  unique  during  HIDECEL 
SUBROUTINE  CONDME 

Adds  conductors  to  the  conductivity  list  during 
surface  connectivity  calculations. 

SUBROUTINE  CONDUC 

Places  conductor  numbers  with  surface  cells  during 
OBJDEF. 

SUBROUTINE  CONECT 

Connects  line  segments  for  contour  plots. 

SUBROUTINE  CONPLT 

Major  contour  plot  routine  including  labeling. 

SUBROUT I NE  CONPOT 

Sets  potentials  on  grid  points  interior  to  the 
satellite  to  the  satellite  structure  potential. 

These  points  don’t  enter  the  calculation,  but 
would  make  the  plots  misleading  if  they  were  left  at 
zero  potential. 

SUBROUTINE  CONTOR 

Low  level  contour  plot  utility. 

SUBROUTINE  CONTUR 

Utility  to  draw  a single  contour  line  on  an  Eulerian 
grid.  Used  during  contour  plotting. 

SUBROUTINE  COORD 

Generates  three  dimensional  coordinates  for  each 
surface  cell  according  to  NASCAP’s  storage 
conventions.  The  values  are  used  for  the  SATPLT  and 
HIDCEL  calculations. 

SUBROUTINE  COPROD 

Performs  multiplication  of  the  finite  element  matrix 
with  the  potential  array  during  the  three  dimensional 
scaled  conjugate  gradient  iterative  potential  solver. 

SUBROUTINE  COROUS 

Converts  code  charge  to  physical  units  of  charge 
density  taking  into  account  grid  interfaces. 


SUBROUTINE  CROEFF 

Called  by  CELGET  to  calculate  spacecraft  effective 
radius  for  use  in  potential  and  boundary  condition 
scaling  which  is  dependent  upon  Debye  length. 
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SUBROUTINE  CSSCAL 

Rescales  small  capacitances  to  account  for  finite 
screening  length.  These  capacitances  are  used  in  the 
charge  integration  algorithms. 

SUBROUTINE  CUBE56 

Called  during  object  definition  to  define  a 
truncated  cube;  that  is  a cube  with  a tetrahedron 
removed . 

SUBROUTINE  CURCND 

Prints  conductor  and  so  called  "battery"  currents 
during  the  current  integration  calculations. 

SUBROUTINE  CURINS 

Calculates  low  energy  emission  from  insulating 
surface  cells. 

SUBROUTINE  CURW 

Low  level  plot  routine  to  draw  curves  consisting  of 
connected  line  segments. 

SUBROUTINE  CUTOFF 

Increases  effective  flux  derivatives  in  anticipation 
of  low  energy  electron  flux  being  cutoff. 

SUBROUTINE  CYLNDR 

Places  zeroes  in  the  potential  array  exterior  to  a 
cylindrical  boundary. 

SUBROUTINE  DATETM 

Gets  date  and  time  from  the  system  clock. 

SUBROUTINE  DCODE 

Determines  type  and  value  of  free  format  input. 
SUBROUTINE  DEADLN 

Determines  whether  NASCAP  should  exit  based  upon  time 
of  day.  Used  to  prevent  computing  center  personnel 
from  killing  a run  when  shutting  down  for  scheduled 
system  maintenance. 

SUBROUTINE  DEDSET 

Sets  the  deadline  used  in  the  above  routine. 
SUBROUTINE  DEFOPT 

Called  by  NASCAP  to  set  all  default  input  options. 
SUBROUTINE  DELETE 

Declares  a volume  cell  to  be  empty  and  deletes  all 
surface  cells  within  it  or  pointing  out  of  it. 
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SUBROUTINE  DETDUM 

Dummy  routine  called  by  NASCAP  to  run  the  detector 
module.  This  routine  was  created  to  solve  a mappino 
problem. 

SUBROUTINE  DETECT 

Subroutine  to  calculate  particle  energy  -flux  as  a 
-function  o-f  detector  orientation  -for  each  detector 
located  on  a specific  surface  cell.  Fluxes  are 
determined  usin9  reverse  trajectory  particle  pushing. 

SUBROUTINE  DETPLT 

Plots  the  particle  flux  data  generated  by  the  detector 
routines. 

SUBROUTINE  DETRUN 

High  ievei  detector  routine  which  calls  other  routines 
which  get  detector  requirements,  set  parameters, 
perform  calculations,  and  plot  results. 

SUBROUTINE  DETSET 

Initializes  detector  parameters  using  keyword  input 
data. 

SUBROUTINE  DFACST 

Sets  perspective  distance  factor  for  use  in  hidden 
line  satellite  plots. 

SUBROUTINE  DFDV 

Calculates  approximate  derivative  of  the  particle  flux 
re®pect  to  changes  in  the  surface  cell  potential. 

SUBROUTINE  DFDVMX 

the  maximum  allowable  value  for  the  flux 
derivative  to  prevent  the  surface  potential  of  any 
cell  from  changing  more  than  DVLIM  in  a timestep. 

SUBROUTINE  DFIELD 

Finds  electric  fields  for  pushing  particles  during  the 
detector  calculations. 

SUBROUTINE  DIAGNO 

Print  routine  for  the  surface  cell  list  called  during 
object  definition. 

SUBROUTINE  DIHEDA 

Calculates  the  angle  between  two  adjacent  surface 
cells.  Called  when  calculating  the  connectivity 
matrix. 

SUBROUTINE  DIM4 

Low  level  boom  matrix  routine  called  during  object 
definition. 
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SUBROUTINE  DIM4Q 

Low  level  boom  matrix  routine  called  during  object 
definition. 

SUBROUTINE  DIRINT 

Routine  to  perform  direct  integration  of  spectral  data 
points  using  Gaussian  weights. 

SUBROUTINE  DISCHG 

Checks  to  see  if  discharge  criteria  are  satisfied.  If 
so,  charge  is  redi stributed  according  to  type  of  discharge. 
This  routine  is  called  during  the  integration  of 
particle  currents. 

SUBROUTINE  D ISP AC 

Routine  to  handle  the  special  case  of  a discharge  to 
space  based  upon  the  magnitude  of  the  surface 
potential . 

SUBROUTINE  DIVIDE 

Low  level  routine  to  check  denominator  size  prior  to 
performing  division  to  prevent  divide  checks  . 

SUBROUTINE  DLINEV 

Low  level  routine  which  draws  l.ines  connecting  a 
series  of  points. 

SUBROUTINE  DOPLOT 

Prints  convergence  plots  during  potential 
cal cul at i ons. 

SUBROUTINE  DOSRAT 

Provides  the  integrand  for  the  dose  rate  integral  for 
determining  radiation  induced  conductivity. 

SUBROUTINE  DQSCND 

Redistributes  charge  accumulation  taking  into  account 
conduction  currents. 

SUBROUTINE  DRAWV 

Low  level  plot  interface  which  produces  vector  drawn 
characters.  For  labels  on  plots. 

SUBROUTINE  DRISCM 

Driver  for  construction  of  point  list  and  surface 
conductivity  matrix  during  OBJDEF.  Calls  GENMTL. 

SUBROUTINE  DTPUSH 

Three  dimensional  leap — Frog  particle  pusher  used  by 
the  dectector  routines. 
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SUBROUTINE  DVLMIT 

Called  during  the  current  integration  to  restrict  the 
difference  between  trial  potentials  and  orginal 
potentials  to  DVLIM. 

SUBROUTINE  ECUBE 

Element  stiffnes  matrix  residual  evaluator  for  an 
empty  cube. 

SUBROUTINE  EFIELD 

Computes  the  local  electric  field  at  a point  exterior 
to  the  object.  Used  to  push  particles  by  particle 
tracking  routines. 

SUBROUTINE  EFPREP 

Performs  storage  manipulations  preparing  common  blocks 
prior  to  the  use  of  EFIELD. 

SUBROUTINE  ELBEAM 

Analytically  calculates  Rutherford  scattering 
including  magnetic  field  effects.  Used  for  multiple 
gun  tank  simulations. 

SUBROUTINE  ELFLUX 

Calculates  the  incident,  secondary  and  backscattered 
electron  fluxes  to  a specific  surface  cell.  Calls 
lower  level  routines  for  models  of  the  physical 
processes. 

SUBROUTINE  ELIMIT 

Cuts  back  emission  of  low  energy  electrons  to  take 
into  account  surface  electric  fields. 

SUBROUTINE  EL SEC 

Generates  electron  secondary  emission  coefficient  for 
a given  incident  spectrum.  Called  by  ELFLUX. 

SUBROUTINE  ELSEC 

Identical  routine  as  ELSEC  but  relabeled  for  efficient 
segment at ion. 

SUBROUTINE  EMDIST 

Sets  up  the  energy  and  angle  distribution  of  emitter 
particles. 

SUBROUTINE  EMFIXR 

Subroutine  to  handle  stubborn  cases  in  which  particle 
refuses  to  follow  a reasonable  trajectory  which  passes 
through  a numbered  volume  cell  just  prior  to  passing 
through  a cell  surface. 

SUBROUTINE  EM I SET 

Initializes  emitter  parameters  in  common  block  EMIT 
using  keyword  input. 
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SUBROUTINE  EM I TER 

Calculates  current  density  array  -for  a given  emitter 
located  on  a specific  surface  cell. 

SUBROUTINE  EMTFLX 

Calculates  currents  to  surface  cells  resulting  from 
emitter  particles  returning  to  the  object. 

SUBROUTINE  EMTRUN 

High  level  emitter  routine  which  calls  other  routines 
to  initialize  parameters  and  perform  emitter 
cal cul ati ons. 

SUBROUTINE  ENPRT 

Prints  out  potential  , kinetic  and  total  energies  to 
check  conservation  in  emitter  particle  pushing 
routines. 

SUBROUTINE  EPBOOM 

Evaluates  electric  fields  and  potentials  in  boom 
cells. 

LOGICAL  FUNCTION  EQUAL 

Compares  two  packed  integers  prior  to  using  XORR. 
FUNCTION  ERFC 

Calls  routine  to  evaluate  error  function. 

SUBROUTINE  ESPEC 

Calculates  electric  fields  for  partially  filled  cells. 
The  cell  is  assumed  to  be  in  the  standard  orientation 
and  the  resulting  fields  must  be  transformed  back  to 
the  actual  cell  orientation. 

SUBROUTINE  ESURFS 

Calculates  effective  surface  electric  fields  for  all 
surface  cells. 

FUNCTION  BSCAT 

Calculates  the  normal  incidence  backscatter 
coefficient  as  a function  of  atomic  number. 

SUBROUTINE  ETNGUN 

Forwards  particle  tracking  routine  for  single 
monoenergetic  gun  tank  simulation. 

FUNCTION  EXPINT 

Performs  interpolation  between  two  points  assuming 
exponential  behavior  of  the  function.  If  results  are 
inconsistent  then  linear  interpolation  is  performed. 
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SUBROUTINE  FASTRW 

ASCII  Fortran  version  of  FASTIO  rapid  disk  access, 
routine  to  transfer  block  data  to  and  from  mass 
storage. 

SUBROUTINE  FBREAK 

Breaks  up  characters  into  groups  of  contiguous 
characters  which  were  separated  by  blanks.  Used  to 
perform  free  format  reads. 

SUBROUTINE  FCOUNT 

Count  and  decode  the  input  types  specified  in  free 
format  routine  call. 

SUBROUTINE  FILALL 

Calls  FILINP  for  all  grids. 

SUBROUTINE  FILASG 

Assigns  all  required  disc  files. 

SUBROUTINE  FILINP 

Fills  in  internal  boundary  potentials  of  an  outer  grid 
using  values  from  the  grid  nested  inside  . 

SUBROUTINE  FILPX 

in  the  entire  two  dimensional  inner  rectangle  of 
potentials  using  values  from  nested  grids  to  get  a 
plane  of  constant  X for  contour  plotting. 

SUBROUTINE  FILPY 

i°  the  entire  two  dimensional  inner  rectangle  of 
potentials  using  values  from  nested  grids  to  get  a 
plane  of  constant  Y for  contour  plotting. 

SUBROUTINE  FILPZ 

^iiis  in  the  entire  two  dimensional  inner  rectangle  of 
potentials  using  values  from  nested  grids  to  get  a 
plane  of  constant  Z for  contour  plotting. 

SUBROUTINE  FIL111 

Creates  a Hi  filler  surface  during  object  definition. 
SUBROUTINE  FINDBP 

Finds  out  location  of  a boom  point  in  the  point  list. 
SUBROUTINE  FINDPT 

Finds  a given  point  in  the  point  list. 

SUBROUTINE  FINDTM 

Finds  all  the  times  associated  with  spectral  data  and 
stuffs  them  into  a common  block. 

SUBROUTINE  F INFUN 

Dotennines  what  class  of  data  is  on  a free  format 
input  card  image.  (Multigun  test  tank.) 


492 


SUBROUTINE  FINISH 

Called  by  high  level  routines  to  close  plot  -file  and 
exit. 

SUBROUTINE  FINSHV 

Plot  routine  to  close  a graphics  -file. 

SUBROUTINE  F INTER 

Interpolates  between  input  spectral  data  energies  and 
those  required  to  perform  gaussian  quadratures  for 
surface  flux  calculations. 

SUBROUTINE  F INVER 

Adds  necessary  vertices  to  complete  a partially 
shielded  polygon.  Part  of  the  hidden  line  routines 
used  for  shadowing  and  satellite  plots. 

SUBROUTINE  FIXPOT 

Fixes  insulating  surface  potentials  and  conductor 
potentials  prior  to  calling  POTENT. 

SUBROUTINE  FLASH 

Locates  pair  of  cells  with  largest  overvoltage  for 
flashover  calculation. 

SUBROUTINE  FLDCON 

Adds  effects  of  field  enhancement  to  bulk 
conductivity. 

SUBROUTINE  FLUXT1 

Defines  incident  particle  flux  parameters  from  the 
flux  file  for  single  gun  tank  cases  . 

SUBROUTINE  FLXDEF 

Flux  definition  high  level  routine.  Sets  particle 
envi ronment . 

SUBROUTINE  FLXSPA 

Defines  incident  particle  flux  parameters  from  the 
flux  file  for  space  environments. 

SUBROUTINE  FNDSCE 

Finds  surface  conducting  edges. 

SUBROUTINE  FREAD 

Reads  in  experimental  particle  flux  data. 

SUBROUTINE  FREED 

Free  format  read  routine.  Interprets  card  images  where 
data  fields  are  separated  by  blank  spaces. 

SUBROUTINE  FSPACE 

Finds  phase  space  density  from  DeForest  data. 
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SUBROUTINE  FTITLE 

Writes  a plot  frame  with  a user  specified  line  of 
text,  date  and  time  the  routine  was  called,  and  send  a 
frame  eject. 

FUNCTION  SCSTOT 

Sums  the  small  capacitances  over  the  entire  object 
surface. 

SUBROUTINE  GDQTRI 

Gets  estimated  change  in  charge  for  use  in  implicit 
charge  integration  algorithims. 


SUBROUTINE  GENMFA 

Sets  markers  for  interface  boom  cells. 

SUBROUTINE  GENMTL 

High  level  which  generates  the  skeleton  of  the 
LONGTIMESTEP  matrix  and  intializes  it  with  surface 
conductivity  contributions. 

SUBROUTINE  GENSCL 

Generates  records  for  the  surface  cell  sub-list. 
SUBROUTINE  GETBAR 

Calculates  potential  barrier  height  for  emitted 
particles. 

SUBROUTINE  GETBCL 

Sets  up  detector  on  a boom  cel 1 . 

SUBROUTINE  GETBFL 

Calculates  incident  particle  fluxes  to  boom  cells. 
SUBROUTINE  GETCEL 

Retrieves  parameters  of  a specified  surface  cell. 
SUBROUTINE  GETCH 

Generates  incomplete  Cholesky  matrix  for  ICCG 
routines. 

SUBROUTINE  GETDIV 

Gets  diagonal  elements  from  full  three  dimensional 
potential  matrix  for  use  in  scaled  conjugate  gradient 
routine. 

SUBROUTINE  GETDQ 

Gets  change  in  electrical  charge  on  surface  cells. 
Also  finds  effective  field  above  conductors. 

SUBROUTINE  GETFLX 

Finds  explicit  particle  fluxes  for  trial  potentials 
during  current  integration  calculations. 
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SUBROUTINE  GET IGF 

Opens  a plot  -file  if  one  has  not  already  been  opened. 
SUBROUTINE  GETNC 

Determines  the  number  of  conductors  specified  in  a 
given  object. 

SUBROUTINE  GETROT 

Gets  rotation  matrix  to  transform  vectors  for  uniform 
cosine  distribution. 

SUBROUTINE  GJR 

Simple  Gaussian  elimination  matrix  inverter  for  use  by 
hidden  line  routines. 

SUBROUTINE  GJRX 

Same  routine  as  GJR  but  given  different  name  for 
mapping  purposes.  Used  during  object  definition. 

SUBROUTINE  GJRY 

Same  routine  as  GJR  but  given  different  name  for 
mapping  purposes.  Used  during  detector  calculations. 

SUBROUTINE  GUNSHD 

Estimates  particle  shadowing  for  multiple  particle 
guns  in  a laboratory  tank. 

SUBROUTINE  HBOOST 

Increases  particle  timestep  during  emitter 
calculations  to  increase  efficiency. 

SUBROUTINE  HIDCEL 

High  level  routine  which  supervises  the  shadowing  and 
hidden  line  satellite  plot  calculations. 

SUBROUTINE  HIGHQ 

Called  by  LIMCEL  to  unf  ix  nodes  with  impossibly  high 
flux es. 

SUBROUTINE  HREDUC 

Reduces  particle  timestep  during  emitter  calculations 
to  increase  accuracy. 

SUBROUTINE  HISTORY 

Called  by  TRILIN  to  dump  timeplot  information. 
SUBROUTINE  ICCG 

Main  routine  of  the  Incomplete  Cholesky  — Conjugate 
Gradient  iterative  symmetric  linear  equation  solver. 
This  routine  is  called  during  the  implicit  current 
integrati on  al gor i thm. 
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SUBROUTINE  ICCS1 

Sets  up  matrix  and  calls  ICCG  driver. 

SUBROUTINE  ICC61 

Like  ICCG1  , called  by  current  integration  routines  to 
setup  charging  matrix  and  call  ICCG  driver. 

SUBROUTIhE  ICORNS 

Calculates  contributions  of  corner  cells  which  are  at 
mesh  interfaces  to  the  residual  vector.  Low  level 
routine  in  the  three  dimensional  potential  solver. 

SUBROUTINE  IEDGES 

Calculates  contributions  of  edge  cells  which  are  at 
mesh  interfaces  to  the  residual  vector.  Low  level 
routine  in  the  three  dimensional  potential  solver. 

SUBROUTINE  IFACES 

Calculates  contributions  of  cells  which  form  the 
mesh  interfaces  to  the  residual  vector.  Low  level 
routine  in  the  three  dimensional  potential  solver. 

SUBROUTINE  IGFBUF 

Begins  updating  the  plot  buffer  and  write  it  out 
as  required. 

SUBROUTINE  IMPFI 

Implict  flux  routine  which  calculates  the  charge 
required  to  change  the  surface  voltage  from  VO  to 
VTRIal  . 

FUNCTION  INBCEL 

Checks  whether  a point  is  within  a boom  cell. 
SUBROUTINE  INCOND 

Initializes  potentials  of  fixed  voltage  conductors 
during  three  dimensional  potential  solution. 

SUBROUTINE  INDATA 

Initializes  potential  and  current  data  in  accordance 
with  user  options. 

SUBROUTINE  INEIMP 

Processes  input  material  parameters  to  get  them  in  the 
form  necessary  for  secondary  yield  calculations. 

SUBROUTINE  INGUNS 

Reads  FLXDEF  file  to  setup  parameters  for  multiple 
guns  in  a laboratory  test  tank. 

SUBROUTINE  INIPOT 

High  level  routine  which  supervises  initialization  of 
surface  potentials. 
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SUBROUTINE  INISET 

Reads  and  processes  initial  potential  specifications. 
SUBROUTINE  INPLOT 

Initialization  routine  for  printer  plots. 

SUBROUTINE  INPUT 

Main  input  routine  for  object  definition  module. 
FUNCTION  INSIDD 

Double  precision  routine  which  determines  whether  a 
point  is  located  inside  a given  polygon.  Low  level 
routine  in  the  shadowing  section  of  the  code. 

FUNCTION  INSIDE 

Single  precision  version  of  INSIDD. 


FUNCTION  INSID1 

Determines  whether  a particle  has  penetrated  the 
object.  Called  by  the  field  routines  during  particle 
pushing. 

SUBROUTINE  INSLST 

Forms  the  list  of  insulating  surface  cells  after 
calculation  of  the  connectivity  matrix. 

SUBROUTINE  INTCHK 

Calculates  cell  edge  intersections  with  the  polygons 
that  make  up  the  major  object  building  blocks.  Part  of 
shadowing  routines. 

SUBROUTINE  INTSEC 

Called  by  INTCHK  to  calculate  the  intersection 
co-ordinates. 

SUBROUTINE  IN VERS 

Driver  to  call  GJRX  matrix  invertor. 


SUBROUTINE  IOFLX 

Prints  fluxes  to  a given  cell. 

SUBROUTINE  IOSCLP 

Prints  out  potentials  of  all  surface  cells. 
SUBROUTINE  IOSTRS 

Prints  out  electric  field  stresses  for  each  surface 
cel  1 . 


SUBROUTINE  IOXFLX 

Prints  out  fluxes  to  a given  boom  cell. 
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SUBROUTINE  IPSCHG 

Computes  estimated  total  charge  -for  initially 
specified  potentials. 

SUBROUTINE  IPSCND 

Sets  a given  conductor  and  all  cells  overlying  it  to  a 
specified  potential.  Part  of  the  initialization  of 
potentials. 

SUBROUTINE  IPSMAT 

Like  IPSCND,  sets  initial  potentials  , this  time  for 
cells  of  a specified  material  with  a given 
illumi nation. 

SUBROUTINE  IPSPOT 

Called  during  intial ization  of  potentials  to  read  list 
of  cells. 

SUBROUTINE  IRCALL 

Par"t  of  three  dimensional  potential  solver  which  calls 
mesh  interface  routines. 

SUBROUTINE  I SPACE 

Finds  matrix  product  with  potentials  for  the  innermost 
grid  during  the  three  dimensional  potential  solution. 

FUNCTION  I XV 

Flot  routine  to  convert  a user  x coordinate  to  a 
raster  coordinate. 

FUNCTION  IYV 

Plot  routine  to  convert  a user  y coordinate  to  a 
raster  coordinate. 

SUBROUTINE  JACIRC 

Plots  a circle  of  a specified  radius. 

FUNCTION  KBITS 

Machine  dependent  low  level  routine  which  specified 
bits  from  a word.  UNIVAC  version  calls  BITS  ; CDC 
version  uses  a bit  mask. 

SUBROUTINE  KINENG 

Calculated  kinetic  energy  and  modified  polar  emission 
angle  for  particles  used  in  the  emitter  routines. 

SUBROUT I NE  LCODE 

Decodes  an  entry  in  the  element  table  and  returns  cell 
type  and  orientation.  Used  by  the  electric  field 
routines  when  particle  pushing. 

SUBROUTINE  LCTOUC 

Converts  lower  case  ASCII  character  to  upper  case. 
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SUBROUTINE  LIMCEL 

Performs  cell  by  cell  electric  field  limiting  of  low 
energy  emission  as  part  of  the  current  integration 
step.  This  is  a high  level  supervisory  routine  which 
enables  NASCAP  to  treat  barrier  effects  in  spacecraft 
charging. 

SUBROUTINE  LIMITS 

Called  by  mesh  interface  routines  during  three 
dimensional  potential  calculations  to  set  limits  on 
loop  indices. 

SUBROUTINE  LINEUV 

Plot  routine  which  draws  a straight  line  between  two 
points  which  are  specified  in  user  coordinates. 

SUBROUTINE  LINPLJM 

Calculates  the  coordinates  of  the  point  of 
intersection  of  a line  with  a plane.  Part  of  the 
hidden  line  routines. 

SUBROUTINE  LINPLT 

Printer  plotter  routine  called  to  plot  convergence 
criteria  from  the  potential  solver. 

SUBROUTINE  LINSCH 

Low  level  routine  which  performs  a bit  search. 
SUBROUTINE  LLTIV 

Called  during  ICCG  to  calculate  product  with  lower 
triangular  Cholesky  matrix. 

SUBROUTINE  LOWQ 

Unfixes  nodes  having  impossibly  low  fluxes  during  the 
current  integration. 

SUBROUTINE  LQUADV 

Plot  routine  to  fill  in  a quadrangle  with  solid  lines; 
used  for  material  plots. 

SUBROUTINE  LSTMAT 

Completes  construction  of  the  capacitor  model  matrix 
during  the  current  integration. 

SUBROUTINE  LSTMT2 

Same  as  LSTMAT  with  different  name  for  mapping. 
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SUBROUTINE  MAGCMP 

Corrects  initial  particle  velocities  in  the  one  gun 
laboratory  environment  by  taking  into  account  magnetic 
field  curvature  of  orbits. 

SUBROUTINE  MATCAL 

Retrieves  surface  cell  data  for  satellite  plots. 
SUBROUTINE  MATDEF 

Contains  default  surface  material  properties. 
SUBROUTINE  MATPLT 

Plots  satellite  as  seen  from  plus  and  minus  grid 
coordinae  directions.  Each  surface  cell  is  shaded 
according  to  its  surface  material. 

SUBROUTINE  MATPRO 

Processes  material  properties  to  obtain  derived 
quantities  required  by  the  charging  algorithms. 

SUBROUTINE  MAXDEL 

Limits  timestep  to  prevent  roundoff  errors  in  the 
integration  of  particle  fluxes. 

SUBROUTINE  MAXSWR 

Integrates  over  a Maxwellian  spectrum  to  obtain  an 
emitted  flux. 

SUBROUTINE  MIXG2D 

Generates  two  dimensional  interpolants  for  use  in  boom 
cell  matrices. 

SUBROUTINE  MIXG3D 

Linearly  interpolates  2-D  matrices  to  obtain  full 
boom  cell  matrix. 

SUBROUTINE  MMPY 

Low  level  matrix  multiplication  routine  for  rotational 
matri ces. 

SUBROUT  IlsE  MORCOR 

system  routine  to  get  more  memory  during 
execution. 

SUBROUTINE  MOVDAT 

Performs  block  transfers  between  core  and  disc. 
SUBROUTINE  M0VEA1 

Moves  surface  cell  polygon  to  a new  location  on  the 
polygon  list  during  hidden  line  calculations. 

SUBROUTINE  MPTWGT 

Multiplies  boom  weights  during  object  definition. 
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SUBROUTINE  MTWGT 

Calculates  empty  cell  weights  -for  potential 
cal cul ati ons. 

SUBROUTINE  MULGUN 

Calculates  incident  particle  flux  intensity  at  a cell 
for  a multiple  particle  gun  laboratory  environment. 

SUBROUTINE  NASCAP 

The  highest  level,  main  procedure. 

SUBROUTINE  NEWFLX 

Finds  the  next  spectrum  for  use  with  direct 
integrati on  algorithms. 

SUBROUTINE  NEWGRD 

Determines  which  grid  a point  is  in  and  returns  its 
location  in  that  grid’s  units. 

SUBROUTINE  NEWMAT 

Changes  material  properties  after  object  definition. 
Typically  changed  is  the  bulk  resistivity  to  simulate 
degradation. 

SUBROUTINE  NIOOBJ 

Object  definition  routine  to  construct  large 
rectangular  solids  contained  in  shapes  such  as  right 
octagonal  cyl i nders. 

SUBROUTINE  NIIOCT 

Object  definition  routine  to  construct  right  octagonal 
cylinders  and  quasi spheres  from  simpler  components. 

SUBROUTINE  NIOTET 

Like  NIOOBJ  except  constructs  nescessary  tetrahedral 
solids. 

SUBROUTINE  NIOWGE 

Like  NIOOBJ  except  constructs  necessary  wedge  solids. 
SUBROUTINE  NORMSK 

Generate  corner  code  for  right  triangle  surface.  An 
object  definition  routine. 

SUBROUTINE  N0RM3V 

Low  level  routine  to  normalize  a three  component 
vector. 

LOGICAL  FUNCTION  NOTEQL 

Tests  for  inequality  using  exclusive  or  function. 


501 


SUBROUTINE  NUMLTB 

Numbers  element  table  volume  cells  which  border  the 
satellite.  This  is  done  during  abject  definition  and 
the  resulting  list  is  used  by  particle  pushing 
routines. 

SUBROUTINE  NUMPTS 

Counts  the  number  of  points  in  the  point  list. 
SUBROUTINE  NWVTXL 

Sets  up  array  which  identifies  neighbors  of  an 
insulating  surface  cell. 

SUBROUTINE  OBJDEF 

High  level  routine  which  supervises  code  conversion  of 
user  object  specification  into  cell  by  cell  lists  for 
use  by  the  charging  sections. 

SUBROUTINE  OCORNS 

Mesh  interface  routine  from  the  potential  section 
which  handles  corner  cells  in  the  outer  mesh. 

SUBROUTINE  OCTGON 

Decodes  user  OCTAGON  input  for  use  by  object 
definition  routines. 

SUBROUTINE  OCUBE 

Empty  volume  element  matrix  weights  called  by  OCORNS. 
SUBROUTINE  OEDGES 

Mesh  interface  routine  to  handle  potential 
calculations  of  edge  cells  in  the  outer  mesh. 

SUBROUTINE  OF ACES 

Mesh  interface  routine  to  handle  potential 
calculations  of  face  cells  in  the  outer  mesh. 

SUBROUTINE  OLAP 

Checks  for  overlapping  of  two  polygons  as  part  of  the 
shadowing  calculations. 

SUBROUTINE  OLDLIN 

Printer  plot  routine  which  stores  line  information. 
SUBROUTINE  ORCALL 

Calculates  outer  mesh  interface  element  contributions 
to  the  potential  matrix. 

SUBROUTINE  ORDPTS 

Orders  vertices  so  that  the  lowest  index  is  first, 
then  are  counter  clockwise. 

SUBROUTINE  OSPACE 

Calculates  outer  grid  empty  volume  element 
contributions  to  the  potential  matrix. 
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SUBROUTINE  OUTLIN 

Plot  routine  to  draw  an  outline  around  the  user  plot 
area. 

SUBROUTINE  PCPDAT 

Updates  potentials  as  part  of  the  current  integration 
routines. 

SUBROUTINE  PDIL 

Trans-forms  projected  surface  cell  coordinates  -for 
material  plots. 

SUBROUTINE  PDIR 

Same  as  PDIL  but  -for  viewer  along  a negative  axis. 
SUBROUTINE  PERMU 

Generate  permutation  vector  from  element  code.  Used  to 
transform  non  cubic  elements  to  the  standard 
orientation. 

SUBROUTINE  PHCMAT 

Adds  photosheath  conduction  to  the  surface 
conductivity  matrix. 

SUBROUTINE  PHCOND 

Calculates  effective  photoconductivity. 

SUBROUTINE  PHOR 

Area  definition  routine  for  shading  for  material 
plots. 

SUBROUTINE  PHOTOC 

Pushes  particles  with  Maxwellian  energy  distribution 
for  photosheath  calculation. 

SUBROUTINE  PLATE 

Inputs  thin  plate  parameters  during  object  definition. 
SUBROUTINE  PLEMIT 

Plots  emitter  particle  trajectories. 

SUBROUTINE  PLOTCV 

Plots  a square  array  of  four  dots  centered  at  the 
current  point. 

SUBROUTINE  PLPART 

Plots  detector  particle  trajectories. 

SUBROUTINE  PMODQ 

Scales  potentials  by  relative  change  in  total  charge. 
SUBROUTINE  POINT 

Printer  plot  routine  which  plots  a single  point.  Part 
of  the  potential  convergence  plotting. 
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SUBROUTINE  POLYN 

El  i mi  nates  any  redundant  nodes  -from  a polygon.  Part  o-f 
shadowing  calculation. 

SUBROUTINE  POTENT 

Supervisory  routine  for  the  three  dimensional 
potential  solver. 

SUBROUTINE  POTPLT 

Produces  potential  contour  plots  from  the  three 
dimensional  electric  potentials. 

SUBROUTINE  PPJSET 

Sets  up  the  prospective  projection  matrix  for 
shadowing  calculations. 

SUBROUTINE  PRFLUX 

Calculates  proton  (positive  ion)  flux  and  its 
associated  secondary  electrons  for  use  in  the  charging 
calculation. 

SUBROUTINE  PROLIN 

Projects  the  coordinates  of  a point  on  a line  onto  the 
viewer  plane. 

SUBROUTINE  PROSEC 

Low  level  routine  which  calculates  the  proton 
generated  secondary  electron  yield. 

SUBROUTINE  PRSPPJ 

Projects  a point  from  three  space  onto  the  viewer 
plane. 

SUBROUTINE  PRSPPK 

Converts  from  prospective  view  back  to  three  space. 
SUBROUTINE  PRTLIM 

Prints  information  from  LIMCEL,  the  routine  that 
limits  the  emission  of  low  energy  electrons  when 
barriers  are  present. 

FUNCTION  PSURFB 

Calculates  surface  resistance  of  a boom  hal f— segment . 
FUNCTION  PSURFS 

Calculates  surface  resistance  of  a half-cell. 

SUBROUTINE  PSWIT 

Switches  points  in  the  potential  array  to  take  into 
account  bottom  points  on  thin  plates. 
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SUBROUTINE  PTCOMP 

Part  o-f  shadowing  calculation  which  checks  to  see  if 
two  points  are  close  enough  together  to  be  treated  as 
a single  point. 

SUBROUTINE  PTLINE 

Checks  to  see  i-f  a point  is  on  a given  line  segment. 
Part  o-f  shadowing  calculation. 

SUBROUTINE  PTROUS 

Corrects  charge  density  taking  into  account  biased 
conductors. 

SUBROUTINE  PUPDAT 

Updates  the  potential  array  with  the  conjugate 
gradient  solution.  Part  o-f  the  three  dimensional 
potential  solver. 

SUBROUTINE  PUSH 

Calculates  the  incident  -flux  at  a given  surface  cell 
using  reverse  trajectory  particle  pushing. 

SUBROUTINE  PUSHER 

Forward  trajectory  particle  pushing  routine  for 
tracking  emitter  particles. 

SUBROUTINE  PVER 

Permutes  surface  cell  vertices  for  material  plots. 
SUBROUTINE  QCONCP 

Calculates  the  charges  on  fixed  and  biased  conductors. 
Used  to  determine  battery  currents  for  output. 

SUBROUTINE  QDISTR 

Distributes  blowoff  charge  to  other  cells  and 
conductors.  Part  of  the  discharge  model. 

SUBROUTINE  QDOT 

Plots  dotted  material  surface  during  object  definition 
plotting. 

FUNCTION  QEQN 

Low  level  routine  to  solve  for  secondary  yield 
parameter  during  material  properties  input. 

FUNCTION  QEQNZ 

Low  level  routine  to  solve  for  maximum  yield  energy 
durng  materials  properties  input. 

SUBROUTINE  QSPHER 

Object  definition  routine  which  takes  quasi— sphere 
input  and  transforms  it  into  a combination  of  right 
octagonal  cylinders  and  tetrahedra. 


505 


SUBROUTINE  QSUMER 

Sums  the  change  in  computational  space  electric  -field 
in  order  to  obtain  the  total  charge  on  the  object  via 
Gauss's  law.  Used  to  perform  potential  scaling. 

SUBROUTINE  RADCON 

Replaces  intrinsic  material  conductivities  with  their 
radiation  enhanced  values. 

SUBROUTINE  RCPDAT 

Updates  the  residual  vector  during  ICCG.  Part  of  the 
current  integration  step. 

SUBROUTINE  ROOBJ 

Reads  in  object  data  for  a restart. 

SUBROUTINE  RDOPT 

Read  user  run  time  options  from  the  options  file. 
SUBROUTINE  READ AN 

Reads  anisotropic  flux  data  as  part  of  the  environment 
specification. 

SUBROUTINE  RECTAN 

Defines  volume  and  surface  cells  associated  with  a 
rectangular  parallelepiped  as  part  of  the  object 
definition  calculation. 

SUBROUTINE  REDCRD 

Low  level  routine  to  read  a single  card. 

SUBROUTINE  REDFIT 

Read  file  of  fits  to  observed  spectra  to  determine 
range  of  times  available. 

SUBROUTINE  REDO 

Current  integration  routine  which  cuts  back  the 
timestep  if  changes  in  voltages  are  too  great. 

SUBROUTINE  REFIX 

Revises  potential  estimates  for  barrier  limited  cells 
by  using  information  from  neighboring  cells.  Part  of 
the  current  integration. 

SUBROUTINE  REGRID 

Reconstructs  a potential  location  code  for  boom  cells 
which  are  part  of  mesh  interfaces. 

SUBROUTINE  REORDER 

Reorders  a boom  matrix  to  account  for  a particular 
or i entati on . 

SUBROUTINE  REPLOT 

Pointer  plot  routine  which  sets  up  extrema  and 
increments  for  plotting  real  numbers. 

SUBROUTINE  RESCRN 

Rescales  potentials  to  account  for  change  in  plasma 
screening. 
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SUBROUTINE  RESETQ 

Scales  charges  and  potentials  through  out  the  mesh. 


SUBROUTINE  RETRNO 

Low  level  emergency  abort  routine  which  forces  a 
traceback  in  the  case  of  a code  failure. 

SUBROUTINE  REVERT 

In  the  case  of  an  internal  restart,  reverts  the 
capacitances  and  magnetic  fields  back  to  physical 
input  units  from  code  units. 


SUBROUTINE  REWIND 

Positions  files  pointer  to  the  beginning  of  a mass 
storage  file. 

SUBROUTINE  RHOSHE 

Plots  phosheath  electron  density  contours. 

FUNCTION  RNORM 

Computes  a rational  approximation  to  a normal 
distribution. 


SUBROUTINE  ROTATE 

Rotates  the  sun  direction  and  magnetic  field  vectors 
in  time  to  simulate  the  shadowing  of  a spinning  satellite. 

SUBROUTINE  ROUSP 

Plots  charge  density  contours. 

SUBROUTINE  RTSUP 

Finds  appropriate  surface  triangles  for  square  surface 
cells  which  are  superseded  by  right  triangles.  This  is 
an  object  definition  routine. 


SUBROUTINE  RUPDAT 


Updates  the  residual  vector  during  the  three 
dimensional  conjugate  gradient  potential  calculation. 

SUBROUTINE  SATPLT 

High  level  routine  which  performs  satellite  plots. 
SUBROUTINE  SBLIN 

Low  level  routine  to  print  scale  values  on  plot  base 
1 ine. 


SUBROUTINE  SCACTR 

Routine  to  find  the  effective  scattering  center  for 
the  multiple  laboratory  gun  environment. 
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SUBROUTINE  SCALEP 

Guesses  new  potentials  by  scaling  previous  results  by 
the  change  in  total  charge.  Used  to  get  good  initial 
conditions  -for  iterative  potential  solver. 

SUBROUTINE  SCAT 

Rutherford  scattering  calculation  with  magnetic  field 
to  get  current  density  and  angle  of  incidence  for 
multi gun  laboratory  environment. 

SUBROUTINE  SCCYC 

Reorders  the  surface  cells  around  a point  in  cyclic 
order.  Part  of  the  surface  conductivity  matrix 
generation. 

SUBROUTINE  SCREAD 

Reads  in  the  surface  conductivity  list  and  matrix  for 
initialization. 

SUBROUTINE  SEARCH 

Searches  a two  dimensional  mesh  to  find  contour 
levels  for  platting. 

SUBROUTINE  SET ALL 

Sets  all  potentials  to  monopole  value. 

SUBROUTINE  SET AN 

Sets  up  transformation  matricies  for  particle  pushing 
intial  velocities. 

SUBROUTINE  SETAX 

Sets  up  axis  values  for  contour  plots.  The  resolution 
is  that  of  the  coarsest  mesh  so  that  mesh  interfaces 
don’t  cause  wiggles  on  the  plots. 

SUBROUTINE  SETBMI 

Sets  up  matrices  necessary  to  calculate  electric 
fields  in  cells  which  contain  booms.  Used  for  particle 
pushing. 

SUBROUTINE  SETBTS 

Low  level  routine  to  set  bits  in  a computer  word. 

SUBROUTINE  SETCOM 

Sets  values  in  common  blocks. 

SUBROUTINE  SETEWX 

Determines  the  energies  and  weights  to  be  used  for 
optimal  resolution  of  emitted  spectrum. 

SUBROUTINE  SETFAC 

Sets  bit  information  telling  direction  a surface  cell 
is  facing. 
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SUBROUTINE  SEFFL 

Routine  to  set  surfaces  of  a FIL111  building  block. 
SUBROUTINE  SETFOC 

Fills  in  surface  information  for  an  octagon  building 
block. 

SUBROUTINE  SETFTH 

Sets  surface  information  for  a tetrahedron  building 
block. 

SUBROUTINE  SETFWG 

Sets  surface  information  for  a wedge  building  block. 
SUBROUTINE  SET IP 

Sets  inner  grid  potentials  to  zero  for  an  initial 
guess. 

SUBROUTINE  SETLST 

Sets  the  list  of  nodes  whose  potentials  are  fixed 
during  the  three  dimensional  potential  solution. 

SUBROUTINE  SETMAX 

Sets  up  environmental  parameters  for  use  with 
Maxwellian  distributions  for  reverse  trajectory 
particle  tracking. 

SUBROUTINE  SETOP 

Sets  initial  potentials  in  outer  grids  to  zero  with 
the  possible  exception  of  the  outermost  grid  being 
filled  with  the  monopole  potential. 

SUBROUTINE  SETPOP 

Sets  the  potentials  on  the  outer  surfaces  of  the  outer 
grid  to  the  monopole  value. 

SUBROUTINE  SETROT 

Sets  up  a rotation  matrix  for  use  by  the  particle 
pushers  in  the  detector  and  emitter  routines. 
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SUBROUTINE  SEFFL 

Routine  to  set  surfaces  of  a FIL111  building  block. 
SUBROUTINE  SETFOC 

Fills  in  surface  information  for  an  octagon  building 
block. 

SUBROUTINE  SETFTH 

Sets  surface  information  for  a tetrahedron  buildina 
black. 

SUBROUTINE  SETFWG 

Sets  surface  information  for  a wedge  building  block. 
SUBROUTINE  SET  IP 

Sets  inner  grid  potentials  to  zero  for  an  initial 
guess. 

SUBROUTINE  SETLST 

Sets  the  list  of  nodes  whose  potentials  are  fixed 
during  the  three  dimensional  potential  solution. 

SUBROUTINE  SETMAX 

Sets  up  environmental  parameters  for  use  with 
Maxwellian  distributions  for  reverse  trajectory 
particle  tracking. 

SUBROUTINE  SETOP 

Sets  initial  potentials  in  outer  grids  to  zero  with 
the  possible  exception  of  the  outermost  grid  being 
filled  with  the  monopale  potential. 

SUBROUTINE  SETPOP 

Sets  potentials  on  the  outer  surfaces  of  the  outer 

grid  to  the  monopole  value. 

SUBROUTINE  SETROT 

Sets  up  a rotation  matrix  for  use  by  the  particle 
pushers  in  the  detector  and  emitter  routines. 

SUBROUTINE  SETSHE 

Sets  up  data  for  particle  pushing  photo  sheath 
cal cul ati on . 

SUBROUTINE  SETUAV 

^^et  routine  which  defines  relationship  between  user 
coordinates  and  plotting  raster  coordinates. 
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SUBROUTINE  SETUP V 

Plot  routine  to  open  a plot  file  and  establish  default 
parameters. 

SUBROUTINE  SET WE 

Calculates  macro  particle  energies  and  weights  for 
particle  pushing. 

SUBROUTINE  SHIELD 

The  workhorse  routine  in  the  shadowing  / hidden  line 
calculations.  Does  shadowing  calculation  for  a single 
surface  cell  by  a single  large  object  surface. 
Shadowing  is  done  by  looking  for  edge  intersections 
and  redrawing  only  the  exposed  polygon. 

SUBROUTINE  SILHOU 

Draws  satellite  including  booms.  For  use  in  contour 
plots. 

SUBROUTINE  SKEL1 

Initialize  circuit  matrix  skeleton  assuming  no 
conductivity  as  an  early  step  in  the  conductivity 
matr i x construct i on . 

SUBROUTINE  SKEL2 

Adds  surface  conductivity  to  the  matrix  skeleton. 
SUBROUTINE  SLLIN 

Plot  routine  to  print  scale  values  along  the  left 
vertical  axis. 

SUBROUTINE  SMAXMO 

Fits  input  particle  spectrum  to  a double  Maxwellian  by 
the  method  of  moments. 

SUBROUTINE  SOLFLX 

Calculates  the  photelectron  current  density  for  a 
given  surface  cell  during  charging. 

SUBROUTINE  SORTER 

Simple  bubble  sort  utility  for  ordering  short  lists- 
SUBROUTINE  SOURCE 

Converts  user  input  specification  of  a laboratory 
electron  or  ion  source  into  code  units  for  use  during 
charging. 

SUBROUTINE  SPACEF 

Machine  dependent  routine  to  space  forwards  in  a mass 
storage  file. 

SUBROUTINE  SPECEL 

Sets  up  volume  element  information  for  partially 
filled  cells  for  use  in  the  element  table. 
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SUBROUTINE  SPIN 

Simulates  the  shadowing  of  a rapidly  spinning 
satellite  by  averaging  the  shadowing  -from  several 
sun  angles. 

SUBROUTINE  SQCWGT 

Performs  matrix  multiplication  with  permuted  cell 
vertices  during  potential  calculation. 

SUBROUTINE  SQUARE 

Defines  a square  surface  cell  during  object 
definition. 

SUBROUTINE  SRFCLS 

Loops  through  surface  cells  and  gets  their 
contributions  to  the  matrix  product  during  the  three 
dimensional  potential  solution. 

SUBROUTINE  SRTWDS 

Sorts  a one  dimensional  array  of  words  using  a 
heapsort. 

SUBROUT  IlvE  STOPAR 

Stores  particle  trajectories  for  sheath  plot. 

SUBROUTINE  STRESS 

Calculates  electric  field  stresses  within  dielectric 
surface  cell  coatings. 

SUBROUTINE  SUMOPT 

Prints  a summary  of  the  run  time  options. 

SUBROUTINE  SUMQD 

Sums  up  the  charges  on  the  dielectric  surface,  that  is 
all  surfaces  except  the  exposed  conductors. 

SUBROUTINE  SURFB 

Calculates  the  surface  resistance  of  half  a boom  cell 
during  the  conductivity  matrix  setup. 

SUBROUTINE  SURFS 

Calculates  the  surface  resistance  of  half  a square 
surface  cell. 

SUBROUTINE  SWPEN 

Plot  routine  to  request  pen  change  in  order  to  plot  in 
a new  color. 

SUBROUTINE  SWPPTS 

Low  level  routine  which  swaps  the  location  of  data  for 

two  point  entries.  Used  when  ordering  points  for  geometrical 

analysis. 


SUBROUTINE  S3MCHR 

Fortran  routine  which  transfers  characters.  Used  in 
free  format  routines  and  is  necessary  since  the 
language  doesn't  support  string  manipulations. 

SUBROUTINE  S3M0VE 

Do— loop  to  move  an  array  from  source  to  destination. 
SUBROUTINE  S3SET 

Do-loop  to  set  all  members  of  an  array  to  a given  value. 

SUBROUTINE  S3ZER0 

Do— loop  which  zeroes  an  array. 

SUBROUTINE  TABSTF 

Stuffs  the  TAB  common  block  with  data. 

SUBROUTINE  TERROR 

Reports  errors  in  the  multiple  gun  input. 

SUBROUTINE  TETDEL 

Deletes  extraneous  surface  cells  for  tetrahedral 
objects  during  object  definition. 

SUBROUTINE  TETRAH 

Defines  surface  cells  and  volume  elements  for  a 
tetrahedron  object. 

SUBROUTINE  THNRLO 

Performs  material  plot  specifications  for  thin  plates. 
SUBROUTINE  TIMER 

Low  level  routine  which  prints  remaining  job  time. 
SUBROUTINE  T I WARN 

Checks  to  see  whether  enough  time  remains  in  a job 
so  that  a high-level  routine  can  make  a clean  exit. 

SUBROUTINE  TLINEV 

Plot  routine  which  draws  thick  lines. 

SUBROUTINE  TMULT 

Low  level  matrix  multiply  routine  which  transforms 
boom  weights  during  objdef. 

SUBROUTINE  TOGETH 

Low  level  routine  which  packs  character  data  into 
computer  words.  < CDC  only  ) 

SUBROUTINE  TQDOT 

Plots  dots  in  material  plots. 


SUBROUTINE  TRAAN 

Transforms  a rotation  matrix  by  interchanging  axial 
directions. 
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SUBROUTINE  TRANA 

Transforms  eight  cubic  element  vertex  potentials 
according  to  the  cell  orientation  code. 

SUBROUTINE  TRAND 

Transforms  change  in  orbit  length  according  to  cell 
orientation.  Used  during  particle  pushing. 

SUBROUTINE  TRANE 

Transforms  electric  field  vector  from  standard 
orientation  back  to  element  orientation  for  use  in  the 
particle  pushing  routines. 

SUBROUTINE  TRILIN 

High  level  routine  which  oversees  the  charging  and 
potential  calculations. 

SUBROUTINE  TRIPLT 

Material  plot  routine  which  outlines  a triangular  cell 
and  colors  and  fills  it  according  to  the  surface  material 
type. 

SUBROUTINE  TRIPOT 

Performs  tri linear  interpolation  in  an  empty  cubic 
el ement . 

SUBROUTINE  TRIPRD 

Calculates  triple  product  of  three  vectors.  Same  as 
the  determinant  of  the  matrix  composed  of  the  vectors 
as  columns. 

SUBROUTINE  TRISHR 

Shares  cell  values  to  vertices  according  to  tri linear 
interpolants. 

SUBROUTINE  TRNGLS 

Stuffs  appropriate  orientation  code  into  surface  cell 
list  for  right  triangle  surfaces. 

SUBROUTINE  TRPLT2 

Right  triangle  plotting  routine  from  material  plot 
section. 

SUBROUTINE  TURNON 

Modifies  flux  derivative  prior  to  removing  potential 
barrier  and  turning  on  secondary  emission. 

SUBROUTINE  TYPEV 

Prints  characters  on  a plot  frame. 

SUBROUTINE  UAU 

Calculates  inner  product  for  three  dimensional 
potential  routine. 
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SUBROUTINE  UCPDAT 

Updates  vector  at  the  end  o-f  an  ICCG  iteration. 
SUBROUTINE  UNEMIT 

Determines  whether  a particle  emitter  current  is  so 
small  that  the  satellite  potential  responds  over 
several  timesteps.  If  so,  the  underlying  conductor  is 
floated;  if  not  the  conductor  potential  is  fixed  by 
the  current  intergration  routine. 

SUBROUTINE  UNEMT1 

Calls  UNEMIT  routine  for  fixed  conductors  with 
emitters. 

SUBROUTINE  UNFIX 

Unfixes  cells  when  predicted  emission  exceeds  maximum 
possible. 

SUBROUTINE  UNFIXC 

Unfixes  conductors  when  predicted  emission  exceeds 
explicit  estimate. 

SUBROUTINE  UNFREE 

Low  level  routine  which  marks  the  free  format  routine 
as  being  unloaded  by  stuffing  its  memory  locations 
with  blanks. 

SUBROUTINE  UNLOAD 

Low  level  routine  to  mark  the  D— bank  above  the  plot 
library  as  unloaded. 

SUBROUTINE  UNSTOR 

Marks  as  unloaded  D— bank  locations  that  may  have  been 
overwritten  by  the  STOR  common  block. 

SUBROUTINE  UNSURF 

Decodes  thin  plate  surface  cell  material  information 
for  platting. 

SUBROUTINE  URCSET 

Initializes  residual  and  solution  vectors  for  the  ICCG 
potential  solver. 

SUBROUTINE  URSETO 

Initializes  residual  and  solution  vectors  for  three 
dimensional  potential  solver. 

SUBROUTINE  UUPDAU 

Updates  the  solution  vector  in  the  three  dimensional 
potential  solver. 
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SUBROUTINE  UXVEC 

Converts  the  verticies  of  a surface  cell  from  NASCAP 
coordinates  to  plotter  raster  coordinates. 

SUBROUTINE  UXYV 

Performs  the  coordinate  conversion  for  a single 
vertex . 

SUBROUTINE  VADD 

Low  level  routine  which  adds  two  vectors. 

SUBROUTINE  VADDS 

Low  level  routine  which  adds  two  vectors  after 
multiplying  one  by  a scalar. 

SUBROUTINE  VCEMT 

Estimates  the  voltage  change  for  a conductor  which  has 
a particle  emitter. 

SUBROUTINE  VCENTR 

Calculates  the  effective  center  of  charge  for 
calculating  beam  deflection  for  multiple  guns  in  a 
tank.  Presently  restricted  to  the  geometrical  center. 

SUBROUTINE  VCFIX 

Fixes  potentials  of  conductors  consistent  with 
predicted  fluxes. 

SUBROUTINE  VECROT 

Low  level  routine  which  rotates  a vector  about  a 
coordinate  axis. 

SUBROUTINE  VFIX 

Fixes  surface  cell  potentials  to  make  them  consistent 
with  their  predicted  fluxes. 

SUBROUTINE  VMAX 

Predicts  maximum  voltage  change  for  an  object  during  a 
timestep.  Used  for  cutting  back  timestep  if  it  is 
greater  than  user  specified  limit. 

SUBROUTINE  VMULT 

Multiplies  a three  vector  by  a matrix. 

SUBROUTINE  VPRED 

Predicts  surface  cell  potentials  by  solving  implicitly 
the  charging  equations.  Calls  the  ICCS  potential 
sol  ver . 

SUBROUTINE  VSURFS 

Calculates  the  average  surface  potential  above  all 
surface  cells  in  the  element  table  during  CAPACI. 
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SUBROUTINE  WEDGE 

De-fines  a wedge  object's  su-f aces  and  volume  elements. 
SUBROUTINE  WGEDEL 

Deletes  wedge  surface  cells  which  are  internal  or 
superceded. 

SUBROUTINE  WGTIN 

Brings  in  element  weights  for  the  inner  mesh  to  be 
used  in  the  three  dimensional  potential  routines. 

SUBROUTINE  WGTOUT 

Brings  in  element  weights  for  the  outer  mesh  to  used 
in  the  three  dimensional  potential  solver. 

SUBROUTINE  WRDSRT 

Object  definition  routine  which  sorts  the  surface  cell 
list  exclusive  of  the  triangle  bits. 

FUNCTION  XORR 

Low  level  exclusive  or  routine  which  compares  words 
after  converting  lower  case  to  upper  case  (UNI VAC)  or 
truncating  to  four  characters  (CDC) . 

SUBROUTINE  XTRCLS 

Forms  matrix  product  for  boom  volume  elements 
during  three  dimensional  potential  calculation. 

SUBROUTINE  XTRDIV 

Calculated  diagonal  matrix  elements  for  boom  cells. 
Used  for  scaling  the  three  dimensional  matrix. 

SUBROUTINE  XTRFLX 

Calculates  the  explicit  flux  to  boom  cells  as  the 
first  step  in  the  charging  calculation. 

SUBROUTINE  XTRIR 

Forms  matrix  product  for  inner  mesh  interface  cells 
which  have  booms.  Part  of  the  three  dimensional 
potential  calculation. 

SUBROUTINE  XTROR 

Forms  matrix  product  for  outer  mesh  interface  cells 
which  have  booms. 

SUBROUTINE  XTRPTR 

Calculates  charges  on  fixed  and  biased  boom  cells 
after  a potential  calculation. 

SUBROUTINE  XTRQFX 

Calculates  contributions  from  fixed  and  biased  boom 
cells  to  the  total  charge  on  each  conductor. 
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SUBROUTINE  XTRSOL 

Calculates  the  photocurrent  "for  boom  cells. 

SUBROUTINE  ZDRAW 

Low  level  plot  routine  which  moves  the  cursor  to  a 
given  location. 

FUNCTION  ZINT 

Calculates  the  z coordinate  of  a line  where  the  x and 
y values  are  that  of  an  apparent  intersection  in  two 
dimensions  with  another  line.  Used  for  hidden  line 
drawings. 

SUBROUTINE  ZSYSTM 

Preprocesses  electron  secondary  emission  parameters 
during  object  definition  and  new  material 
speci f i cati on. 
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APPENDIX  B 


IMPLEMENTATION  OF  NASCAP  ON  THE  CRAY /IBM  SYSTEM 
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NASCAP,  along  with  several  of  its  utility  routines,  is  now 
functional  on  the  CRAY/IBM  system  at  Lewis  Research  Center.  The  main 
NASCAP  program  exists  on  the  CRAY,  together  with  a routine  CRAYFILES 
to  maintain  NASCAP  restart  files  and  CRAYTOIBM  to  send  to  the  IBM  the 
data  required  by  PLOTREAD,  CONTOURS,  and  TERMTALK,  which  are  resident 
on  the  IBM.  MATCH6  is  resident  only  on  the  IBM.  Libraries  of 
low-level  NASCAP  utility  routines  (e.g.,  FREED)  are  resident  on  both 
machines.  All  files  are  currently  stored  under  the  username 
SEMANDEL.  On  the  CRAY,  all  files  have  ID=NASCAP,  except  for  restart 
files,  which  are  currently  without  ID. 

In  making  this  conversion,  every  effort  was  made  to  maximize 
commonality  of  NASCAP  coding  to  the  various  FORTRANS  used:  UNIVAC 

ASCII  FORTRAN,  CRAY  FORTRAN  (CFT) , and  CDC  FORTRAN  V.  Only  a small 
number  of  routines  in  the  main  NASCAP/GEO  code  need  be  changed  among 
these  three  FORTRANS,  including  some  low-level  I/O  routines  (MOVDAT, 
CELLIO,  REWIND,  SPACEF),  some  executive  request  routines  (ASGFIL, 
DATETM,  S3MC0R,  TIWARN) , some  machine-specific  assembler  routines 
(F2FRT,  F2FCA,  TIMLFT,  SHIFT,  XTIME) , and  a single  routine,  SETCHR, 
defining  bits  per  word,  characters  per  word,  and  bits  per  character. 
Many  more  changes  must  be  made  for  the  version  of  IBM  FORTRAN 
implemented  at  NASA/LeRC,  which  does  not  properly  handle  continuation 

lines. 


The  documentation  which  follows  is  not  intended  as  an  operations 
manual  for  either  system,  but  rather  as  a description  of  the  present 
implementation  of  the  NASCAP  family  of  codes  on  the  composite  system. 

B.l  FREED  (IBM) 

The  IBM  version  of  the  NASCAP  utility  library  may  be  created  by 
compiling  the  file  SOURCE. FREED.  It  is  currently  stored  as  FRDLIB. 
When  using  this  library,  FT47F001  must  be  DDEF’d  as  a scratch  file. 


PRECEDING  PAGE  BLANK  NOT  FILMED 
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B.2  FREED  (CRAY) 


The  source  code  for  the  NASCAP  utility  library  may  be  stored  on 
the  CRAY  by  SUBMITting  the  file  CRAY. FREED.  It  is  compiled  by 
SUBMITting  the  file  CFREED. COMPILE.  The  source  code  is  stored  in 
FREEDPROGLIB  and  the  object  code  -in  FREEDOBJLIB. 

B.3  MATCHG 

The  source  code  for  MATCHG  is  stored  in  SOURCE. MATCHG,  with  the 
main  routine  in  SOURCE. MATCHG $$.  The  object  code  is  stored  in  MTGLIB, 
and  the  default  material  properties  in  MATCHG. DATA.  It  may  be 
executed  by  the  command  (PROC)  MATCHG. 

B.4  CRAYFILES 


The  NASCAP  restart  file  utility  routine  CRAYFILES  may  be  created 
by  SUBMITting  the  file  CRAY. FILES.  To  run  it, 

ACCESS,  DN=FILES,  PDN=CRAYFILES,  ID=NASCAP. 

FILES. 

Commands  are  read  from  $ IN  until  an  /EOF  is  reached.  Available 
commands  are: 

ASSIGN  prefix  - Save  a new  set  of  NASCAP  files. 

ACCESS  prefix  - Make  a set  of  files  local  and  accessible 

through  FORTRAN  logical  unit  numbers. 

ADJUST  prefix  - Properly  close  set  of  NASCAP  files. 

DELETE  prefix  - Delete  set  of  NASCAP  files. 

COPY  prefixl  TO  prefix2  - Copy  from  one  existing  set  of  files 

to  another. 
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The  files  treated  by  CRAYFILES  are: 


Permanent  Name 

Local 

prefix02 

FT02 

prefixlO 

FT10 

prefixl5 

FT15 

prefix 16 

FT16 

prefixl7 

FT17 

pref ix21 

FT  21 

pref ix27 

FT27 

prefixOBJ  . 

FT20 

prefixOPT 

FT26 

prefixFLX 

FT22 

prefixl9 

FT19 

At  present,  files  are  SAVEd,  etc.,  with  no  ID. 

B.5  CRAYTOIBM 

The  utility  routine  CRAYTOIBM  may  be  created  by  SUBMITting  the 
JOB  CRAY.TOIBM.  It  is  used  to  send  restart  files  from  the  CRAY  to  the 
IBM,  where  they  may  be  read  by  PLOTREAD,  CONTOURS,  or  TERMTALK. 
CRAYTOIBM  reads  from  $IN  a card  containing  the  list  of  units  (LUN's) 
to  be  sent,  or  the  literal  'ALL*.  It  writes  to  local  file  (LUN+50), 
which  must  have  previously  been  TASSIGN'ed,  and  must  subsequently  be 
BINOUT'ed.  The  files  required  by  the  various  routines  are: 


Routine 

LUN(S) 

PLOTREAD 

2 

CONTOURS 

10,  17 

TERMTALK 

16,  17 
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To  send  all  five  files: 

ACCESS,  DN=FILES,  PDN=CRAYFILES,  ID=NASCAP 

ACCESS,  DN=T0IBM,  PDN=CRAYTOIBM,  ID=NASCAP 

TASSIGN,  A=FT52,  DN=FT52 

TASSIGN,  A=FT60,  DN=FT 60 

TASSIGN,  A=FT66,  DN=FT 66 

TASSIGN,  A=FT67,  DN=FT67 

TASSIGN,  A=FT71 , DN=FT71 

FILES. 

TOIBM. 

BINOUT,  DN=FT52,  SDN= ' prefix. FILE02' . 

BINOUT,  DN-FT60,  SDN= ' prefix. FILE10 ' . 

BINOUT,  DN=FT66,  SDN=' prefix. FILE16' . 

BINOUT,  DN*FT67,  SDN»' prefix. FILE 17 ' . 

BINOUT,  DN=FT71 , SDN='prefix.FILE21' . 

/EOF 

ACCESS  prefix 
/EOF 

2 10  16  17  21 

/EOF 

Note  that 

1.  TASSIGN  takes  an  inordinate  amount  of  memory.  Using  M=1700, 
only  three  files  can  be  TASSIGN 'ed. 

2.  The  IBM  prefix  (in  the  SDN=  parameter)  need  not  be  the  same  as 
the  CRAY  prefix. 

3.  Any  previous  IBM  file  with  the  name  prefix. FILExx  should  be 
erased  prior  to  sending  a new  one  from  the  CRAY.  Otherwise,  the 
sent  file  will  appear  with  a ridiculous  system  name. 

4.  The  files  sent  from  the  CRAY  will  be  stored  as  'I/O  PENDING' 
files,  and  should  be  properly  disposed  of  in  a timely  fashion. 
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B. 6 NASCAP 


The  NASCAP  source  (excluding  FREED  routines  and  a few 
modifications)  resides  on  the  IBM  in  the  file  CRAY. NASCAP  (suitable 
for  CRAY  submission)  and  on  the  CRAY  in  NASCPR06LIB.  The  source  may 
be  compiled  into  NASCOBJIIB  by  submitting  CRAY. COMPILE.  Sources  for 
routines  found  to  require  correction  during  testing  are  in 
CRAY.NASBLD,  which  will  make  the  corrections  to  NASCOBJLIB.  The 
absolute,  NASCABS,  will  be  created  by  CRAY.NASTRY. 

An  initial-run  NASCAP  runstream  might  be: 

ACCESS,  DN=FILES,  PDN=CRAYFILES,  ID=NASCAP 
ACCESS,  DN=NASCAP,  PDN=NASCABS,  ID=NASCAP 
FILES. 

REWIND,  DN=FILES. 

COPYF,  0=FT20. 

REWIND,  DN=FT20. 

COPYF,  0=FT22. 

REWIND,  DN=FT22. 

COPYF,  0=FT26. 

REWIND,  DN=FT26. 

NASCAP. 

FILES. 

/ EOF 

ASSIGN  prefix 
ACCESS  prefix 

/ EOF 

Object  definition  input 

/EOF 

Environment  definition  input 

/EOF 

Option  input 

/ EOF 

NASCAP  input 

/EOF 

ADJUST  prefix 

/EOF 
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1.  For  subsequent  run,  the  ASSIGN  command  to  CRAYFILES  should  be 
omitted,  and  the  COPYF  commands  may  be  omitted  if  not  needed. 

2.  As  in  other  versions  of  NASCAP,  commands  such  as  OBJDEF  5 cause 
data  to  be  read  directly  from  NASCAP  input  rather  than  from  a 
separate  file. 

3.  In  the  above  runstream,  if  NASCAP  exits  due  to  an  'END'  command, 
the  ADJUST  will  not  be  performed,  as  FILES  will  encounter  the 
/EOF.  Solutions  are  either  (a)  omit  the  'END',  in  which  case 
NASCAP  will  exit  normally  on  encountering  the  /EOF;  or  (b) 
follow  the  'NASCAP."  command  with 

REWIND,  DN=$IN. 

SKIPF,  NF=5. 

which  will  position  $IN  following  the  sixth  '/EOF' 

B.7  TERMTALK,  CONTOURS,  AND  PLOTREAD 

These  routines  are  accessed  by  the  IBM  commands  (procedures) 
TERMTALK  prefix 
CONTOURS  prefix 
PLOTREAD  prefix. 

Their  sources  are  located  in  SOURCE. TTALK,  SOURCE. CONTOURS,  and 
SOURCE. I BMPLOT,  and  their  objects  in  LIB. TERMTALK,  LIB. CONTOURS,  and 
LIB.IBMPLOT.  The  procedures  contain  statements  to  DDEF  the 
appropriate  files  with  DSNAME=pref i x . F I LExx  (see  CRAYTOIBM) . 

Operation  on  the  IBM  is  similar  to  the  UNIVAC.  See  the  TSS/370 
Graphics  Manual  for  plot  destinations. 
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